O que significa
O cliente enviou requisições demais em um dado período (limitação de taxa). Retry-After pode dizer quanto esperar.
Causas comuns
- Limites de taxa ou cotas da API excedidos
- Loops de repetição sem backoff
- Muitos usuários atrás de um IP compartilhado
Como resolver
Se você é o cliente ou visitante
Respeite o Retry-After, use backoff exponencial com jitter, faça cache de resultados e agrupe requisições.
Se você mantém o site ou a API
Retorne Retry-After e cabeçalhos RateLimit para os clientes se adaptarem, e limite por chave ou usuário, não só por IP.
Resposta de exemplo
HTTP/1.1
HTTP/1.1 429 Too Many Requests
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 30
RateLimit-Policy: 100;w=60
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Too Many Requests",
"status": 429,
"detail": "Rate limit of 100 requests per minute exceeded."
}Especificação
Perguntas frequentes
› Quanto devo esperar depois de um 429?
Use o Retry-After se houver; senão, faça backoff exponencial, por exemplo 1, 2, 4, 8 segundos com jitter aleatório.
› O 429 prejudica o SEO?
O Googlebot reduz o rastreamento quando vê 429. Períodos curtos não têm problema; longos podem atrasar a indexação.