公开 API

翻过结果，并留在限额之内

列表类端点用游标分页而不是偏移量，所以请跟着响应给你的游标走，别自己算。盯住限流响应头，并用 updatedSince 去轮询，而不是把一切重读一遍。

最后校订 2026年8月20日

步骤

1. 跟着每次响应里的游标走，直到不再返回游标为止。别自己造游标。
2. 页大小取得合理些——更大的页意味着更少的请求，但也更慢。
3. 用 updatedSince 轮询，而不是按时把整个集合扫一遍。
4. 读限流响应头，在被拒之前就减速，而不是之后。
5. 把每一次失败的 requestId 存下来，留给支持团队。

如何验证结果

完整走一遍会把每个对象各返回一次，而反复轮询只读那些变过的。

常见的出错之处

• 搭基于偏移量的分页，数据在底下一变，它就错位了。
• 每分钟把一切重读一遍，然后撞上限额。
• 复用了过期的游标，收到游标无效的报错。