result_count, previous_token, next_token을 포함하는 meta 객체가 있습니다. XDK는 next_token을 사용하여 여러 API 호출을 처리하므로 개발자는 여러 호출을 하지 않아도 원하는 데이터 양을 지정하기만 하면 됩니다.
SDK는 다음과 같이 이를 단순화합니다:
- 내장 이터레이터: 원활한 다중 페이지 가져오기를 위해 제너레이터 함수를 사용합니다.
- 명시적 토큰 처리: 필요할 때
pagination_token을 전달하여 유연한 수동 제어가 가능합니다. - 최대 결과 적용: 호출당
max_results를 준수합니다(API 제한까지, 예: search의 경우 100).
자동 페이지네이션 (권장)
페이지네이션된 응답에 대해iterate() 메서드를 사용하여 모든 결과를 지연 가져옵니다.
예시: 페이지네이션된 검색
Example
- 이터레이터는
next_token을 자동으로 처리합니다. next_token이 없으면 중지합니다.- 429 오류를 피하기 위한 속도 제한 백오프를 지원합니다.
수동 페이지네이션
사용자 지정 로직(예: 페이지별 처리)을 위해 결과를 제어해야 하는 경우, 아래와 같이next_token을 사용하여 수동으로 페이지네이션을 수행할 수 있습니다:
Example
- 최적화를 위해 항상
max_results를 지정하세요(기본값은 엔드포인트마다 다름). - 디버깅을 위해
meta.result_count를 모니터링하세요. - 매우 큰 쿼리의 경우 차단을 피하기 위해 비동기 반복을 고려하세요. Python XDK를 사용하는 자세한 코드 예제는 코드 샘플 GitHub 저장소를 확인하세요.