Limites de taxa#
Cada chave de API tem um limite padrao de 100 requisicoes por minuto. Voce pode ajustar o limite individual de cada chave no momento da criacao (ate o teto do seu plano).Toda resposta inclui informacao sobre o estado atual do seu limite:| Header | Descricao |
|---|
X-RateLimit-Limit | Limite maximo da chave |
X-RateLimit-Remaining | Requisicoes restantes na janela atual |
X-RateLimit-Reset | Timestamp Unix quando a janela reseta |
Excedendo o limite#
Requisicoes acima do limite retornam HTTP 429 Too Many Requests com o header Retry-After indicando quantos segundos esperar antes de tentar novamente:Boas praticas#
Implemente backoff exponencial ao receber 429: espere o tempo do Retry-After, depois duplique a espera em falhas subsequentes
Respeite X-RateLimit-Remaining e reduza a frequencia quando estiver proximo de zero
Use webhooks ao inves de polling quando quiser reagir a mudancas em tempo real — isso evita consumir o orcamento de requisicoes atoa
Agrupe operacoes usando endpoints de lista com filtros ao inves de muitas chamadas individuais
Modified at 2026-04-18 19:47:35
