Entenda os limites de requisições aplicados à API para garantir estabilidade e desempenho.
Para garantir a estabilidade, segurança e desempenho da API, aplicamos limites de requisições. Eles funcionam em duas camadas complementares:
Limite principal (uso contínuo)
Você pode realizar até 1.000 requisições a cada 5 minutos, o que equivale a uma média aproximada de 3 requisições por segundo. Esse limite controla o uso regular da API ao longo do tempo.
Limite de proteção contra picos (burst limit)
Além do limite principal, existe um limite adicional de segurança: 200 requisições a cada 5 segundos. Esse mecanismo evita picos repentinos de chamadas que poderiam impactar a saúde e a estabilidade da aplicação, mesmo que o limite principal ainda não tenha sido atingido.
Comportamento em caso de excesso
Requisições que ultrapassarem qualquer um desses limites receberão como resposta o status 429 – Too Many Requests. Você deve esperar para que o limite seja restabelecido para voltar a disparar mensagens.
Escopo: os limites citados acima são aplicados por conta.
Dicas para evitar atingir o limite
Algumas boas práticas ajudam a manter sua integração estável e evitam respostas 429 – Too Many Requests.
- Evite loops sem controle: laços que disparam requisições em sequência (especialmente for ou while) devem sempre ter algum tipo de atraso ou controle de volume.
- Implemente retry com espera (backoff): se receber um 429, aguarde alguns segundos antes de tentar novamente. Repetir imediatamente tende a piorar o problema.
- Distribua as chamadas ao longo do tempo: em vez de disparar muitas requisições de uma vez, espalhe-as de forma uniforme para manter uma média estável.
Dicas específicas para quem usa n8n
O n8n é poderoso, mas pode gerar picos de requisições sem perceber. Algumas configurações ajudam bastante:
- Use o node Wait: após chamadas em massa ou dentro de loops, utilize o node Wait para inserir um atraso entre as execuções. Mesmo um intervalo pequeno (ex: 500 ms) já reduz drasticamente o risco de atingir o limite.
- Controle a concorrência: ao usar nodes como HTTP Request e Split In Batches, evite executar muitos itens em paralelo. Prefira processar em lotes menores e sequenciais.
- Configure corretamente o Split In Batches: use tamanhos de lote menores (ex: 10 ou 20 itens) e combine com o node Wait entre os lotes para suavizar o volume de chamadas.
- Trate o erro 429 explicitamente: configure o fluxo para detectar o erro 429, aguardar alguns segundos e repetir a requisição automaticamente. Isso evita falhas no workflow e respeita os limites da API.