返回工具常见问题
帮助中心 · 常见问题工具1 分钟阅读

如何确认已获取工具返回的全部分页结果?

即使还有更多匹配记录,响应也可能只包含一页。应持续使用续页令牌、游标或下一页标记,直到明确结束;请求间保持筛选条件和排序一致,避免漏项或重复。

工具

遵循分页约定

检查工具返回的是游标、偏移量、页码还是明确的完成标记。只有 API 文档规定时,短页才可视为结束;有些系统仍会提供续页标记。

分页期间保持查询参数和排序不变。如果记录可能在过程中变化,应使用稳定排序键或快照机制,并按稳定记录标识去重。

操作前确认结果完整

将获取数量与工具提供的总数或完成元数据进行比较。若没有总数,应记录游标链,并确认最后响应不再包含下一页标记。

批量更新或导出时保存进度,以便从最后一个已确认游标继续。删除、对账或报告总量时,不要把部分结果当成完整集合。

返回工具常见问题