公開 API

翻過結果，並留在上限之內

清單類端點用游標分頁而不是位移量，所以請跟著回應給你的游標走，別自己算。盯住流量上限標頭，並用 updatedSince 去輪詢，而不是把一切重讀一遍。

最後校訂 2026年8月20日

步驟

1. 跟著每次回應裡的游標走，直到不再回傳游標為止。別自己造游標。
2. 每頁筆數取得合理些——更大的頁意味著更少的請求，但也更慢。
3. 用 updatedSince 輪詢，而不是按時把整個集合掃一遍。
4. 讀流量上限標頭，在被拒之前就減速，而不是之後。
5. 把每一次失敗的 requestId 存下來，留給支援團隊。

如何驗證結果

完整走一遍會把每個物件各回傳一次，而反覆輪詢只讀那些變過的。

常見的出錯之處

• 搭基於位移量的分頁，資料在底下一變，它就錯位了。
• 每分鐘把一切重讀一遍，然後撞上上限。
• 重用了過期的游標，收到游標無效的錯誤。