meta com result_count, previous_token e next_token. O XDK cuida de fazer múltiplas chamadas de API usando o next_token, para que os desenvolvedores possam apenas especificar quanto dados desejam sem precisar fazer múltiplas chamadas.
O SDK simplifica isso com:
- Iteradores integrados: Use funções geradoras para busca contínua de múltiplas páginas.
- Tratamento explícito de tokens: Para controle manual flexível quando necessário, passando
pagination_tokenconforme apropriado. - Aplicação de Max Results: Respeita
max_resultspor chamada (até os limites da API, por exemplo, 100 para pesquisa).
Paginação automática (recomendado)
Use o métodoiterate() em respostas paginadas para buscar todos os resultados de forma preguiçosa.
Exemplo: pesquisa paginada
Example
- O iterador trata
next_tokenautomaticamente. - Para quando não há um
next_tokenpresente. - Suporta backoff de limite de taxa para evitar erros 429.
Paginação manual
Se você precisar controlar os resultados para alguma lógica personalizada (por exemplo, processando página por página), ainda pode usar onext_token e fazer a paginação manualmente, como mostrado abaixo:
Example
- Sempre especifique
max_resultspara otimizar (o padrão varia por endpoint). - Monitore
meta.result_countpara depuração. - Para consultas muito grandes, considere iteração assíncrona para evitar bloqueios. Para exemplos de código detalhados usando o XDK Python, confira nosso repositório de exemplos de código no GitHub.