meta con result_count, previous_token y next_token. El XDK se encarga de realizar varias llamadas a la API usando el next_token para que los desarrolladores solo tengan que especificar cuántos datos buscan, sin necesidad de hacer varias llamadas.
El SDK simplifica esto con:
- Iteradores integrados: Usa funciones generadoras para obtener múltiples páginas sin fricción.
- Manejo explícito de tokens: Para control manual y flexible cuando lo necesites, pasando
pagination_token. - Aplicación de max results: Respeta
max_resultspor llamada (hasta los límites de la API; por ejemplo, 100 para búsqueda).
Paginación automática (recomendada)
Usa el métodoiterate() en las respuestas paginadas para obtener todos los resultados de forma perezosa.
Ejemplo: búsqueda paginada
Example
- El iterador maneja
next_tokenautomáticamente. - Se detiene cuando no hay
next_token. - Admite backoff por rate limit para evitar errores 429.
Paginación manual
Si necesitas controlar los resultados para alguna lógica personalizada (por ejemplo, procesar página por página), aún puedes usar elnext_token y hacer la paginación manualmente como se muestra a continuación:
Example
- Especifica siempre
max_resultspara optimizar (el valor por defecto varía según el endpoint). - Monitorea
meta.result_countpara depurar. - Para consultas muy grandes, considera la iteración asíncrona para evitar bloqueos. Para ejemplos de código detallados usando el Python XDK, consulta nuestro repositorio de ejemplos de código en GitHub.