7장. API에서 페이지 번호 사용

API는 컬렉션에 대한 응답을 페이지 매깁니다. 즉, 컬렉션에 수십 또는 수십만 개의 오브젝트가 포함될 수 있지만 각 웹 요청에는 API 성능상의 이유로 제한된 수의 결과만 반환됩니다.

컬렉션에 대한 결과가 표시되면 다음과 유사한 내용이 표시됩니다.

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

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

Copy to Clipboard

Toggle word wrap

프로세스

"다음" 순차 URL에서 제공한 페이지를 요청하여 다음 페이지로 이동합니다.
page_size=XX 쿼리 문자열 매개변수를 사용하여 각 요청에 대해 반환된 결과 수를 변경합니다.
- page_size 의 기본 최대 제한은 200이며, 사용자가 값을 시도할 때 적용됩니다(예: ?page_size=1000 ). 그러나 /etc/tower/conf.d/<some file>.py 의 값을 더 높은 값으로 설정하여 이 제한을 변경할 수 있습니다. 예를 들어 MAX_PAGE_SIZE=1000 입니다.

페이지 쿼리 문자열 매개변수를 사용하여 특정 결과 페이지를 검색합니다.

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

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

Copy to Clipboard

Toggle word wrap

결과와 함께 반환된 앞의 링크에서는 이러한 쿼리 문자열 매개변수를 자동으로 설정합니다.

200보다 큰 페이지 크기를 요청하지 마십시오.

사용자 인터페이스는 스크롤을 피하기 위해 더 작은 값을 사용합니다.