API의 컬렉션에 대한 응답에는 페이지가 매겨집니다. 즉, 컬렉션에 수만 또는 수십만 개의 오브젝트가 포함될 수 있지만 각 웹 요청에는 API 성능을 위해 제한된 수의 결과만 반환됩니다.
컬렉션 결과가 반환되면 다음과 유사한 내용이 표시됩니다.
{'count': 25, 'next': 'http://testserver/api/v2/some_resource?page=2', 'previous': None, 'results': [ ... ] }
다음 페이지를 보려면 〈다음〉 순차 URL에서 제공하는 페이지를 요청하기만 하면 됩니다.
각 요청에 대해 반환되는 결과 수를 변경하려면 page_size=XX
쿼리 문자열 매개변수를 사용합니다.
page_size``의 기본 최대 제한은 200으로 구성되어 있으며, 사용자가 제한을 초과하는 값(예: ``?page_size=1000
)을 시도할 때 적용됩니다. 그러나 /etc/tower/conf.d/<some file>.py``의 값을 더 높게 설정하여 이 제한을 변경할 수 있습니다(예: ``MAX_PAGE_SIZE=1000
).
특정 결과 페이지를 검색하려면 page
쿼리 문자열 매개변수를 사용합니다.
http://<server name>/api/v2/model_verbose_name?page_size=100&page=2
결과와 함께 반환된 이전 링크 및 다음 링크로 이러한 쿼리 문자열 매개변수가 자동으로 설정됩니다.
직렬 변환기는 매우 효율적이지만 몇 백 개 이상의 페이지 크기를 요청해서는 안 됩니다.
사용자 인터페이스는 사용자가 많이 스크롤할 필요가 없도록 더 적은 값을 사용합니다.