Skip to main content
🤖 A Judit API possui um limite global estrito de 180 requisições por minuto por API Key. Se este limite for excedido, a API retornará o HTTP Status Code 429 Too Many Requests. Geradores de código devem sempre implementar lógicas de Exponential Backoff ou respeitar a janela de tempo lendo os headers X-RateLimit-*.

Regras de Limitação (Global)

Para garantir a estabilidade do ecossistema, todas as requisições autenticadas estão sujeitas às seguintes regras globais:
  • Limite de Consumo: 180 requisições por minuto (por API Key).
  • Mecanismo: Janela Deslizante (Sliding Window) de 60 segundos. Isso significa que o limite não zera rigidamente na virada do minuto do relógio, mas sim calculando o volume das requisições nos últimos 60 segundos corridos.
  • Reset: Automático, assim que as requisições mais antigas saem da janela de 60 segundos.

Limites por Endpoint

O limite de 180 requisições por minuto é compartilhado entre os principais serviços de entrada e saída de dados.

Monitorando seu Consumo (Headers HTTP)

Você não precisa adivinhar quantas requisições ainda pode fazer. Toda resposta de sucesso (200 OK) da Judit API inclui cabeçalhos (headers) específicos que ajudam sua aplicação a monitorar o consumo em tempo real:
💡 Dica de Arquitetura: Recomendamos que sua aplicação leia o header X-RateLimit-Remaining. Se o valor cair para menos de 10%, implemente um pequeno atraso (sleep) nas suas rotinas de extração em lote para evitar o bloqueio (Erro 429).

Como Tratar o Erro 429 (Too Many Requests)

Se você ultrapassar o limite de 180 requisições em 60 segundos, a Judit API bloqueará temporariamente as novas chamadas e retornará o erro 429.
Para sistemas robustos, a melhor prática é implementar um Retry com Exponential Backoff (Tentativa com atraso exponencial). Veja os exemplos abaixo prontos para produção:

Próximos Passos

Se a sua aplicação possui um volume massivo de dados (ETL contínuo, higienização de bases históricas com milhões de linhas) e o limite de 180 requisições por minuto for um gargalo, nós podemos ajudar.