公開API

結果をたどり、上限の内側に留まる

一覧のエンドポイントはオフセットではなくカーソルでページを刻みます。自分で計算せず、応答が返すカーソルをたどってください。レート上限のヘッダーに目を配り、すべてを読み直す代わりに updatedSince でポーリングします。

最終確認 2026年8月20日

手順

1. カーソルが返らなくなるまで、各応答のカーソルをたどります。カーソルを自作しないでください。
2. ページサイズは適度に保ちます。大きいほど要求は減りますが、遅くなります。
3. 定時に全件を走査するのではなく、updatedSince でポーリングします。
4. レート上限のヘッダーを読み、拒否されてからではなく、その前に減速します。
5. 失敗したものの requestId は、サポート用に保存します。

結果の確かめ方

一巡の走査ですべてのオブジェクトが一度ずつ返り、繰り返しのポーリングは変わったものだけを読みます。

よくある落とし穴

• オフセット方式のページ送り。下でデータが変わるとずれます。
• 毎分すべてを読み直して上限にぶつかる。
• 古いカーソルを再利用して、無効なカーソルのエラーを受け取る。