7. ページネーション¶

API でのコレクションの応答は、ページネーションされます。つまり、コレクションには数十万のオブジェクトが含まれる可能性がありますが、Web の各要求では、API のパフォーマンスの確保を目的として、一定数の結果しか返されません。

返される結果は以下のようになります。

{'count': 25, 'next': 'http://testserver/api/v2/some_resource?page=2', 'previous': None, 'results': [ ... ] }

次のページに進むには、next の次にある URL を要求します。

各要求で返される結果の数を変更するには、page_size=XX クエリー文字列パラメーターを使用します。

特定のページの結果を取得するには、page クエリー文字列パラメーターを使用します。

http://<Tower server name>/api/v2/model_verbose_name?page_size=100&page=2

結果で返される previous および next のリンクは、これらのクエリー文字列パラメーターを自動的に設定します。

シリアライザーは効率的ですが、200 を超えるサイズのページは要求しない方がよいでしょう。

ユーザーがスクロールで苦慮しないように、ユーザーインターフェースでは小さめの値を使用します。