Erro 429 Too Many Requests: o que é e como resolver

Entenda o erro 429 Too Many Requests nos dois lados: quando o seu site devolve o código com o Nginx e quando você recebe 429 de uma API, inclusive no n8n.

Por Redação Eleven Host · @robson.direitodigital · 28 de outubro de 2026 · 7 min de leitura

O erro 429 Too Many Requests significa que você enviou pedidos demais em pouco tempo e o servidor pediu calma. A resposta pode trazer o cabeçalho Retry-After, com o tempo de espera. A causa pode estar no seu site ou na API que você chama.

Este guia atende dois leitores. O primeiro é o dono de um site que está devolvendo 429 aos visitantes, por exemplo com um limite de pedidos no Nginx. O segundo é quem recebe o 429 de uma API de terceiros, num script, num app ou num fluxo do n8n. O nome seudominio.com.br é um exemplo. Troque pelo endereço do seu site.

O que significa o erro 429 Too Many Requests

Segundo a MDN, o código de resposta HTTP 429 Too Many Requests indica que o usuário enviou muitos pedidos em um determinado período de tempo. A MDN diz também que um cabeçalho Retry-After pode ser incluído na resposta, indicando quanto tempo o usuário deve esperar antes de fazer um novo pedido.

O exemplo da MDN mostra três linhas. O valor do Retry-After é dado em segundos, e 3600 segundos equivalem a 1 hora:

HTTP/1.1 429 Too Many Requests

Content-Type: text/html

Retry-After: 3600

Em linguagem simples, é um "calma aí": o servidor ou a API contou os seus pedidos e você passou do limite. Isso o separa de dois erros parecidos na tela:

• 503: o servidor não pode atender agora. Veja o guia Erro 503 Service Unavailable: o que é e como resolver.
• 403: o acesso foi proibido. O guia Erro 403 Forbidden: o que é e como resolver no seu site trata desse caso.
• 429: o acesso é permitido, mas o ritmo de pedidos passou do limite.

Os dois lados do 429

Antes de mexer num arquivo, descubra de que lado você está. Há duas situações bem diferentes:

• Lado 1: o seu site devolve 429 aos visitantes. Você é quem aplica o limite, e a correção está na configuração do servidor.
• Lado 2: você (um script, um app ou o n8n) recebe 429 de uma API de terceiros. O limite é do outro lado, e a correção é pedir menos, ou mais devagar.

Para conferir o código que o seu site está devolvendo, use o comando abaixo. Ele mostra só os cabeçalhos da resposta:

curl -I https://seudominio.com.br

Olhe a primeira linha, que traz o status (por exemplo, HTTP/2 429). Se houver uma linha retry-after, ela diz quanto tempo o servidor pede para você esperar.

Seu site devolve 429: o limit_req do Nginx

Segundo a documentação do Nginx, o módulo limit_req limita os pedidos por segundo. O exemplo da documentação cria uma zona de 10 MB chamada "one", com média de 1 pedido por segundo para cada endereço:

limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

Depois, a diretiva limit_req aplica a zona. Com burst=5, o Nginx aceita uma rajada de até 5 pedidos na fila:

limit_req zone=one burst=5;

Com a opção nodelay, os pedidos da rajada não são atrasados. Ajuste o rate e o burst ao seu tráfego.

Quando o visitante passa do limite, o Nginx recusa o pedido. Por padrão, ele responde 503, porque o padrão da diretiva limit_req_status é 503. Para que ele responda 429, defina o código:

limit_req_status 429;

As recusas vão para o log de erro, no nível error por padrão. Para achar, procure as linhas com "limiting requests":

sudo grep "limiting requests" /var/log/nginx/error.log | tail -n 20

Depois de mudar a configuração, teste a sintaxe e recarregue o Nginx:

sudo nginx -t

sudo systemctl reload nginx

Se o nginx -t apontar erro, corrija a linha indicada antes de recarregar. Se o log não tiver nenhuma linha de limite, o 429 pode vir de outra origem, tema da próxima seção.

Quer um servidor para hospedar o seu site? Os planos de VPS saem a partir de R$ 17,00/mês, no Plano Bronze; confira na loja o que cada plano inclui. Ver planos de VPS

Outras origens possíveis do 429 no seu site

Se o Nginx não tem nenhum limite configurado, o 429 pode vir de outra camada na frente do site. Entre as possibilidades estão um plugin de segurança, um firewall de aplicação e as regras de limite da Cloudflare. Confira a configuração de cada camada que você usa e veja se há um limite de pedidos ativo.

O Fail2ban é parecido, mas funciona de outro jeito: bloqueia o endereço IP do visitante em vez de responder 429. O guia Fail2ban na VPS: como instalar e proteger o SSH explica como ele atua.

E o Google? O 429 e o rastreamento

Para quem tem um site que aparece nas buscas, o 429 tem um efeito a mais. Segundo o Google Search Central, os erros de servidor 5xx e 429 solicitam aos rastreadores do Google que desacelerem temporariamente o rastreamento.

O Google informa que os URLs já indexados são preservados, mas podem ser descartados se o erro continuar. Por isso, um limite apertado demais pode atingir também o robô do Google, e não só os visitantes mal-intencionados. Se o seu site responde 429, confira se o limite não está barrando o rastreador.

Você recebeu 429 de uma API

Quando o limite é da API que você chama, a correção está no seu lado do pedido. Há três ações que ajudam:

• Respeite o Retry-After. Se a resposta trouxer o cabeçalho, espere esse tempo antes de tentar de novo.
• Espace os pedidos. Em vez de mandar tudo de uma vez, distribua os pedidos no tempo.
• Tente de novo com espera crescente. Em scripts, espere e repita o pedido, aumentando a espera a cada tentativa.

No n8n, o nó HTTP Request tem a opção "Batching", com os campos "Items per Batch" e "Batch Interval". O intervalo é dado em milissegundos, e o nó manda os itens em lotes, com uma pausa entre eles. Nas configurações do nó existe ainda o "Retry On Fail". Segundo a documentação do n8n, quando a execução falha, o nó roda de novo até conseguir.

O guia n8n com ChatGPT: como usar a API da OpenAI nos fluxos mostra um caso em que um fluxo chama uma API externa.

Já escolheu o endereço do seu site? Registre o seu domínio na Eleven Host. Registrar domínio

Perguntas frequentes

O que é o erro 429 Too Many Requests?

Segundo a MDN, é o código de resposta HTTP que indica que o usuário enviou muitos pedidos em um determinado período de tempo.

O que é o cabeçalho Retry-After?

A MDN diz que ele pode ser incluído na resposta e indica quanto tempo o usuário deve esperar antes de fazer um novo pedido. No exemplo da MDN, o valor 3600 equivale a 1 hora, porque é dado em segundos.

Como fazer o Nginx responder 429 em vez de 503?

Por padrão, o limit_req recusa com 503. A diretiva limit_req_status 429; faz o Nginx responder 429. Depois, rode sudo nginx -t e sudo systemctl reload nginx.

O erro 429 prejudica o site no Google?

O Google informa que os erros 5xx e 429 fazem os rastreadores desacelerarem o rastreamento temporariamente, e que os URLs já indexados são preservados, mas podem ser descartados se o erro continuar.