Skip to main content
🤖 A paginação da Judit API não utiliza cursores. Ela é baseada no padrão Offset, utilizando exclusivamente os parâmetros de query page (número da página) e page_size (quantidade de itens). O limite máximo estrito para page_size é de 1000 itens. Os metadados de paginação são retornados na raiz do objeto de resposta.

Como Funciona a Paginação

Parâmetros de Query (Requisição)

Ao realizar listagens (como buscar histórico de requisições ou monitoramentos), você pode enviar os seguintes parâmetros na URL:

Estrutura da Resposta (Payload)

As respostas de endpoints paginados sempre retornam os metadados de navegação na raiz do JSON, e os itens propriamente ditos geralmente vêm no array page_data.

Exemplos Práticos

Consulta Básica com Paginação

Abaixo, demonstramos como buscar a primeira página de requisições e iterar sobre os dados.

Otimizações e Boas Práticas

Para lidar com grandes volumes de dados de forma eficiente e sem ser bloqueado pela API, siga as recomendações abaixo.

1. Adequação do page_size

Adapte o tamanho da página de acordo com a necessidade da sua aplicação, lembrando sempre do limite de 1000 itens por requisição.

2. Controle de Rate Limit (Iteração Segura)

A Judit API possui limites rigorosos de requisições por minuto. Ao construir loops para extrair todas as páginas, é obrigatório implementar um pequeno atraso (delay) entre as chamadas para evitar o erro 429 Too Many Requests.
Nota sobre Processamento Paralelo: Removemos o exemplo de processamento concorrente (threads) porque disparar múltiplas páginas em paralelo quase certamente causará bloqueio por Rate Limit (Erro 429), a menos que sua aplicação tenha uma gestão de fila distribuída robusta. Recomendamos sempre o processamento sequencial com delay ou filas controladas.

Próximos Passos

  • 👉 Rate Limits: Entenda as quotas de requisições da sua conta.
  • 👉 Autenticação: Revise como enviar suas credenciais.
  • 👉 Endpoints: Explore os recursos que suportam listagem.