<!-- 429 Too Many Requests: causas e soluções — Uptimely -->
> Markdown version of https://getuptimely.com/pt-BR/errors/429 — the page itself is the canonical copy.

Guia de erros

# 429 Too Many Requests

O cliente atingiu um limite de taxa: o servidor está descartando as requisições dele de propósito para se proteger.

Um 429 significa que o cliente enviou requisições demais e que o servidor está recusando as próximas por enquanto. Não é uma falha no sentido usual: o servidor está saudável e está se protegendo de propósito ou aplicando uma cota. Um 429 bem implementado inclui um cabeçalho Retry-After dizendo quanto tempo esperar.

É o código mais interessante para a operação na classe 4xx, porque é o único que diz algo confiável sobre capacidade, e não sobre correção. Uma taxa de 429 em alta com o comportamento dos clientes inalterado significa que o crescimento está batendo nos limites, que os limites foram apertados ou que algo está repetindo tentativas com muito mais agressividade do que antes.

No monitoramento ele tem uma armadilha particular: um monitor que verifica com frequência pode atingir um limite de taxa sozinho, principalmente quando vários monitores compartilham um IP de saída com outro tráfego. O alerta então descreve o monitoramento, não o serviço.

## Causas comuns

- Tráfego real excedendo um limite de taxa ou uma cota configurados.
- Um loop de novas tentativas sem backoff transformando uma falha passageira em uma falha sustentada.
- Verificações de monitoramento em intervalo curto contando contra o mesmo limite que o tráfego real.
- Limitação de taxa aplicada por IP onde muitos clientes compartilham um endereço, então um vizinho barulhento esgota a cota de todos.
- Uma cota de API, diária ou mensal em vez de por segundo, que se esgotou no período.
- Um WAF ou produto de borda limitando requisições que ele classifica como automatizadas.

## Como diagnosticar

1. Leia o Retry-After e quaisquer cabeçalhos X-RateLimit: eles costumam informar o limite, a cota restante e o horário de reinício.
2. Descubra qual camada está limitando (a CDN, um gateway de API ou a aplicação), porque cada uma tem a própria configuração.
3. Verifique se o limite é por IP, por chave ou por conta, o que determina quem está de fato competindo por ele.
4. Procure uma tempestade de novas tentativas: um cliente sem backoff transforma uma resposta lenta em centenas de requisições.
5. Se o monitoramento estiver envolvido, aumente o intervalo de verificação ou coloque o monitor numa lista de permissões em vez de remover o limite.

## De quem é a culpa? Depende da camada

O servidor está funcionando como projetado, então formalmente a culpa é do cliente por exceder o limite. Mas um 429 que chega a usuários reais é um problema de capacidade ou de configuração que vale tratar como um incidente do lado do servidor.

## O que o monitoramento vê

A Uptimely registra o código de status, então um 429 aparece como o que é, e não como uma falha anônima. Se as próprias verificações estão disparando o limite, a solução é um intervalo maior ou uma lista de permissões na borda: um monitor cujos alertas são causados pelo próprio monitor é a fonte mais clara possível de fadiga de alertas.

## Guias de erros relacionados

- [Erros 4xx de cliente](https://getuptimely.com/pt-BR/errors/4xx)
- [503 Service Unavailable](https://getuptimely.com/errors/503)
- [403 Forbidden](https://getuptimely.com/errors/403)
- [408 Request Timeout](https://getuptimely.com/errors/408)

## Termos usados nesta página

- [Fadiga de alertas](https://getuptimely.com/glossary/alert-fatigue)
- [Intervalo de verificação](https://getuptimely.com/glossary/check-interval)
- [Desempenho degradado](https://getuptimely.com/glossary/degraded-performance)

## Perguntas

### Um 429 é tempo de inatividade?

Para o cliente que o recebe, na prática sim: a requisição não teve sucesso. Para o serviço, está funcionando como projetado. Se ele deve aparecer na sua página de status depende de quem está atingindo o limite: usuários reais ou apenas clientes automatizados.

### Meu monitor de uptime pode causar erros 429?

Sim, principalmente em intervalos curtos ou quando vários monitores compartilham um IP de saída com outro tráfego. Aumente o intervalo ou coloque o monitor numa lista de permissões na borda; não remova o limite de taxa para fazer uma verificação passar.

Um dos [guias de erros HTTP e de rede da Uptimely](https://getuptimely.com/pt-BR/errors), escritos para quem opera o servidor, e não para quem recarrega a página. Something here read wrong to you? Email **support@getuptimely.com**.

Verificado em 2026-11-15 pela equipe do Uptimely.
