RESTful API 페이지 매김 예제
일부 조직에는 수천 개의 AP가 포함된 인벤토리가 있습니다. API GET 요청으로 모두 보려는 경우 기본적으로 응답이 단일 페이지에서 페이지 매김 없이 반환되기 때문에 어려울 수 있습니다. 에 X-Page-Page X-Page-Total 대한 X-Page-LimitHTTP 헤더 매개 변수를 추가하고 API GET 요청에 반환된 데이터에 페이지 매김을 활성화할 수 있습니다. 이를 통해 사용 가능한 모든 항목을 가져오는지 또는 다음 페이지를 쿼리해야 하는지 알 수 있습니다.
페이지는 X-Page-Limit 페이지당 최대 결과 수를 정의합니다. 제한은 기본적으로 100이고 최대값은 1000입니다. 그러나 여기에는 몇 가지 예외가 있습니다.
은 X-Page-Page 페이지 결과의 최대 수를 정의합니다.
은(는 X-Page-Total ) 목록의 총 항목 수를 정의합니다. 합계는 보고 있는 항목과 목록에 있는 항목 수에 따라 다릅니다.
이 정보를 조정하기 위해 사용 중인 API 인터페이스의 웹 URL 끝에 쿼리 매개변수를 추가할 수 있습니다. API 호출에 따라 응답 본문에서 생성되고 전송되는 "다음" URL의 끝에 매개 변수를 대신 추가해야 할 수 있습니다("다음"이 있는 경우).
코드 블록을 재사용하는 경우 자리 표시자 값을 API 토큰, 조직 ID, 사이트 ID, AP 이름 등과 같은 실제 값으로 바꿉니다.
다음 예제에서 limit=2&page=47 을 추가하면 X-Page-Limit 및 X-Page-Page 매개변수가 조정됩니다.
https://api.mist.com/api/v1/orgs/:org_id/inventory?limit=2&page=47
아래 예제는 페이지 매김을 포함하는 GET 요청의 형식을 보여줍니다.
Request URL: https://api.mist.com/api/v1/orgs/:org_id/inventory Request Method: GET Status Code: 200 OK Date: Thu, 16 May 2019 04:22:05 GMT Request Headers: X-Page-Limit: 100 X-Page-Page: 1 X-Page-Total: 193
Django 웹 인터페이스에서 요청할 때 Mist로부터 받는 응답은 다음과 같습니다.
사용법에 대한 자세한 내용은 Mist API Reference를 참조하십시오. 페이지 매김