Rate limiting

A API aplica limites de requisições por minuto para garantir estabilidade e uso justo. Ao exceder o limite, a resposta será HTTP 429 e os headers indicam quando retentar.

Tabela de limites

Headers de rate limit

Em todas as respostas (sucesso ou erro), a API pode incluir os seguintes headers:

• X-RateLimit-Limit — Número máximo de requisições permitidas na janela atual.
• X-RateLimit-Remaining — Quantas requisições ainda podem ser feitas na janela.
• X-RateLimit-Reset — Timestamp (Unix) em que a janela é renovada.

Retry-After

Em respostas 429, o header Retry-After indica quantos segundos esperar antes de tentar novamente. Respeite esse valor para evitar bloqueios temporários.

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1739102400
Retry-After: 42

Boas práticas

• Implemente backoff exponencial ao receber 429: espere o tempo de Retry-After antes de retentar.
• Evite picos de requisições; distribua chamadas ao longo do tempo quando possível.
• Monitore os headers X-RateLimit-* para antecipar quando está próximo do limite.
• Para listagens grandes, use paginação (page/limit) em vez de buscar tudo de uma vez.