HTTP 429 Too Many Requests (Excesso de requisições)
O cliente enviou requisições demais em pouco tempo (limite de taxa).
Ficha rápida
| Código | 429 |
|---|---|
| Nome oficial (em inglês) | Too Many Requests |
| Nome em português | Excesso de requisições |
| Grupo | Erro do cliente (4xx) |
| Definido em | RFC 6585 |
| Quem costuma gerar | O servidor, apontando um problema na requisição enviada pelo cliente. |
O que significa
O cliente enviou requisições demais em um intervalo de tempo e foi limitado (rate limiting). A resposta pode trazer o cabeçalho Retry-After, que diz quanto esperar antes de tentar de novo. O pedido em si está correto; ele foi enviado com frequência alta demais.
Quando o servidor devolve esse código
- API que limita requisições por minuto ou por dia.
- Proteção contra abuso ou excesso de tentativas de login.
Problemas comuns
- Laços ou automações sem pausa entre as chamadas.
- Muitos usuários compartilhando a mesma chave de API.
- Limite diário esgotado.
Como resolver
- Respeite o Retry-After e espere o tempo indicado.
- Reduza a frequência e a concorrência das chamadas.
- Use repetição com espera crescente (backoff).
- Peça um limite maior ao provedor, se o uso é legítimo.
Em automações e integrações
A documentação do Azure Logic Apps, base do Power Automate, descreve uma política de repetição padrão que reenvia a requisição em caso de resposta 408, 429 ou 5xx, com intervalos crescentes e até 4 tentativas. Mesmo assim, reduza a concorrência para não depender dela.
Não confunda com outros códigos
Não confunda com 503: no 429 você pediu demais; no 503 o servidor está indisponível para todos.
Exemplo de resposta
HTTP/1.1 429 Too Many Requests Retry-After: 27
O exemplo é ilustrativo: o corpo e os cabeçalhos reais mudam de servidor para servidor. O código e o nome seguem o padrão HTTP.
Perguntas frequentes
O que é Retry-After?
Um cabeçalho que informa em quantos segundos (ou até que data) o cliente pode tentar de novo.
Aumentar a concorrência resolve?
Não. Costuma piorar, porque aumenta o número de pedidos simultâneos.