P215 · 工具调用

确认分页数据已全部读取

Prove paginated retrieval is complete

按接口规则读取后续页,明确区分完整结果和只取到部分数据。

编辑审核

以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。

使用场景

你要对声明筛选范围内的全部订阅者聚合,首页成功不说明完整。教学响应页1含50条和meta.next_cursor=c2,页2含20条并返回null;过滤条件与访问范围固定。游标只按服务返回原样续接。

具体做法

核对接口分页和终止契约,记录输入范围、每页数与续接值。顺序读后续页并按稳定身份累计,只有规定终止且所有页成功才称范围内完整。页失败、权限错误、重复游标或预算上限保留部分状态和下一位置;不能用总数未知或首页成功推断完成。

反例

用第一页50条计算全部订阅者指标,看到200就报告完整,不看c2或后续页失败。

改进写法

按教学meta.next_cursor契约读取页1→c2→页2→null,保持同一筛选/账号范围,累计70条并核对身份。只有两页成功和null终止才报告范围内完整;失败或到上限列页数、实际条数、未决游标与部分状态,不猜未读数据或绕过配额。

为什么这样改

单页传输成功只覆盖该页,明确终止条件提供未读范围已经处理的依据。范围与游标保持一致,也避免一次聚合混入不同过滤结果。

如何验证

教学成功结果是两页70条且终止null;第二页失败则只有50条部分结果。故意重复c2要被识别为异常,不无限循环。

检查终止证据、页数和身份映射,而不仅比条数;本篇不查询真实订阅者。

适用边界

完整性仅针对声明过滤和权限,动态数据可能需要快照语义。不同端点的page/offset/cursor终止规则不相同;冻结字段是实例,不是所有分页都返回null。

原文与版本

如何收录这些方法