SuperAPI AI 工具集

knack reader

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:通过 REST 接口访问 Knack 的 Objects 和 Views,进行数据提取与转换,是读取 HTI 在 Knack 中运营数据的主要技能。

主要能力:提供两个核心函数。get_records 调用 GET /v1/objects/{object_key}/records,参数含 object_key(必填,如 object_1、object_5)、rows_per_page(可选,默认 1000,最大 1000)、page(可选,默认 1)、filters 和 sort(可选,详见 knack_filter_sort)。get_view_records 调用 GET /v1/pages/{scene_id}/views/{view_id}/records,参数含 scene_id、view_id(均必填)和可选的 user_token,用于按视图规则获取数据,包括计算字段、显示规则和权限过滤。

使用方式:请求头需带 X-Knack-Application-Id(HTI Knack 应用 ID)和 X-Knack-REST-API-Key(认证密钥)。返回格式含 records、total_pages、current_page、total_records。常见对象键涵盖笔记本电脑库存、捐赠方记录、培训场次、县区分布等。

适用场景:用于季度报告,统计已获取笔记本数量、已转换或就绪设备、已丢弃或回收设备、培训出勤等。

集成与限制:配合 knack_pagination 拉取完整数据集,knack_filter_sort 优化查询,knack_cache_optimizer 提升性能,knack_data_cleaner 做取后校验。超过 1000 条需分页;建议缓存常用数据并用 filters 减小数据量;速率上限为每秒 10 次请求。常见错误包括 401 凭证错误、404 键值无效、429 超限、500 需指数退避重试。未提供内容:具体部署方式、价格与平台支持信息。