O que é Rate limit?

O que é rate limit

Rate limit é uma restrição à frequência ou à quantidade de chamadas permitidas por um serviço durante determinado período. Ele pode limitar o acesso de uma credencial, de uma organização ou de um recurso específico, conforme o contrato da API.

Uma integração que sincroniza inscrições precisa usar essa capacidade disponível sem presumir que cada workflow tem uma cota própria. Se três automações compartilham a mesma credencial, o destino soma as chamadas das três.

Quantidade, intervalo e escopo

Informar sessenta chamadas por minuto descreve apenas parte da política. Você ainda precisa saber como o serviço mede esse minuto, se aceita um pico de chamadas de uma vez e se há outros limites aplicados ao mesmo endpoint.

Uma janela fixa reinicia seu cálculo em momentos definidos, enquanto uma janela móvel considera o período recente. Outros mecanismos permitem um pico limitado e repõem gradualmente a capacidade, por isso duas APIs com o mesmo total anunciado podem recusar sequências diferentes de chamadas.

Como interpretar uma recusa

O status HTTP 429 Too Many Requests é usado para indicar excesso de chamadas. A resposta pode trazer informações adicionais, como o prazo de espera e o motivo específico, mas o formato e a presença desses campos dependem do serviço.

1
HTTP/1.1 429 Too Many Requests
2
Retry-After: 30

Nesse exemplo, o header orienta uma espera de trinta segundos antes de nova tentativa. O mesmo header também pode usar uma data HTTP, então a integração precisa interpretar o formato recebido e respeitar as instruções da API.

Nem toda falha simultânea é causada pelo rate limit, e nem todo 429 identifica exatamente a mesma restrição. Leia os detalhes da resposta para distinguir o limite global, o limite de um endpoint e outras condições que o fornecedor documentar.

A concorrência mede outra coisa

A concorrência controla quantas tarefas ficam em andamento ao mesmo tempo. Uma tarefa rápida pode fazer muitas chamadas em sequência, enquanto várias tarefas lentas podem passar boa parte do tempo aguardando sem realizar novos acessos.

Também confira o consumo gerado por paginação e retries. Uma sincronização que busca dez páginas e repete duas chamadas usa uma parcela maior da cota que a estimativa baseada apenas no número de execuções do workflow.

Como distribuir o trabalho

Uma fila e um controle compartilhado de envio podem distribuir chamadas conforme a capacidade disponível. Separar cem contatos em dez batches de dez itens ainda produz cem chamadas se cada contato for enviado individualmente. O lote define o agrupamento do trabalho, enquanto a quantidade de requisições depende de como a integração envia seus itens.

Depois de uma recusa, repetir imediatamente pode consumir mais recursos sem produzir resultado. O backoff deve respeitar a orientação do serviço e encerrar conforme os limites definidos para a recuperação.

Como verificar o consumo

Registre o endpoint, o horário, a credencial identificada de forma não sensível e o resultado de cada chamada. Compare o consumo conjunto com o escopo documentado e confira se a espera é aplicada também às novas tentativas.

O teste precisa considerar outras automações que usam a mesma cota. Um fluxo que funciona sozinho ainda pode receber recusas quando a importação, a sincronização e o relatório diário executam juntos.

Aplicação na formação

n8n Experts

Rate limits estabelecem limites de chamadas que a integração precisa respeitar ao acessar um serviço.

Conhecer a formação →