offsetおよびlimitクエリパラメータを使用してコレクション内の項目のページ割りを行います。
オフセットベースのページネーションは、項目のリストがあらかじめ決められた固定長の場合によく使用されます。
ページング
コレクション内のエントリの最初のページを取得するには、APIをoffsetパラメータを指定せずに呼び出すか、offsetを0に設定して呼び出す必要があります。limitフィールドは省略可能です。
offset値と以前の結果で返された制限の合計 (previous_offset + previous_limit) と等しいoffsetパラメータを指定して、APIを呼び出す必要があります。
offsetは、レスポンス配列内のエントリのサイズではなく、以前のlimit分だけ加算されますので注意してください。これは制限を下回る可能性があるためです。一般的には、レスポンスオブジェクトのlimitの値を使用してoffset値を加算することをお勧めします。offset値がレスポンスオブジェクト内のtotal_count値を超えている場合、項目の最終ページはリクエスト済みです。この時点では、これ以上取得する項目がありません。
オフセットと制限
以下のクエリパラメータは、コレクションのページネーションに使用されます。オフセットベースのページネーションの最大
offsetは9999です。さらに大きいオフセットが必要な場合はマーカーベースのページネーションをお勧めします。