用途:在遵守 Knack API 单次请求最多 1,000 条记录限制的前提下,完整获取全部数据,适用于超过 1,000 条记录的库存与合规报表场景(资料提到 3,500+ 台笔记本电脑清点)。
主要能力:fetch_all_pages 跨页拉取完整数据集,支持 object_key、rows_per_page(默认 1000)、filters、sort 参数;paginate_with_progress 通过 on_page 回调显示分页进度;stream_records 按批处理(如每次 1,000 条)以节省内存;还提供限流处理与错误重试逻辑。
使用方式:调用 get_records 获取每页数据并拼接,翻页时用 sleep(100) 控制每秒最多 10 次请求;可按 429 状态码做指数退避重试。资料示例包括按 acquisition_date 过滤的季度报表、按 target_county 分组的县级统计、近 12 个月捐赠分析,以及仪表盘只取首页 100 条等。
集成点:knack_reader 提供基础 get_records,knack_cache_optimizer 缓存分页结果,knack_filter_sort 跨页统一过滤排序,knack_reporting_sync 用于季度报表全量检索。
限制与注意:受 API 速率限制(10 req/sec),并行取页需限流;建议生产数据集一律分页、缓存全量分页结果并显示进度。其他事实资料未提供。