4294xx · Erro do cliente
HTTP 429 Too Many Requests
O 429 Too Many Requests indica que o limite de requisições foi estourado. É a resposta padrão de rate limiting.
O que significa
Limite de requisições estourado. A requisição tem algum problema — quem chamou precisa corrigir.
Quando usar
Rate limiting — devolva Retry-After dizendo quando tentar de novo.
Especificação: RFC 6585
Causas comuns
- Volume de chamadas acima da cota do plano
- Laço sem intervalo disparando requisições em sequência
- Retentativa agressiva após falha, sem espera progressiva
- Várias instâncias compartilhando a mesma chave de API
Como resolver
- Respeite o header Retry-After antes de tentar de novo
- Implemente espera exponencial com variação aleatória nas retentativas
- Use cache para reduzir chamadas repetidas
- No servidor, informe X-RateLimit-Limit e X-RateLimit-Remaining para o cliente se planejar
Exemplo de resposta
HTTP/1.1 429 Too Many Requests
Retry-After: 30
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0Perguntas frequentes
- Como tratar 429 corretamente no cliente?
- Leia o Retry-After e aguarde o tempo indicado. Se ele não vier, aplique espera exponencial com variação aleatória — repetir imediatamente costuma prolongar o bloqueio.