Rate limit

Definição

Rate limit é a restrição sobre a quantidade ou a frequência de operações permitidas. O contrato define o limite, o intervalo e o escopo, e o cliente precisa respeitar esse ritmo. Ultrapassar o limite muda o comportamento da chamada, que passa a ser recusada ou marcada para espera.

Quantidade, intervalo e escopo

Uma API fictícia pode aceitar sessenta chamadas por minuto. O escopo do limite pode valer para uma chave, para um endereço ou para toda a conta, e o consumo precisa ser distribuído dentro do intervalo. O limite de sessenta não significa sessenta de uma vez, e sim sessenta dentro da janela de um minuto.

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

Controle distinto

O rate limit controla frequência ou volume, e não é o mesmo que limitar tarefas simultâneas. Os dois controles aparecem juntos em fluxos reais, mas medem coisas diferentes e precisam de configuração própria. Uma tarefa única pode estourar o limite de chamadas, e dez tarefas lentas podem não chegar perto dele.

Limite excedido e verificação

A falha comum é tratar todas as recusas como erro do fluxo: quando o limite é excedido, as chamadas voltam recusadas e o processamento para sem identificar o motivo. Para verificar, confira o status da chamada recusada e o cabeçalho que indica quanto tempo esperar. Quando as recusas começam juntas no mesmo intervalo, o consumo passou do limite do período, e a comparação entre a quantidade enviada e o limite do contrato mostra o descompasso a corrigir.

Aplicação na formação

n8n Experts

Na formação n8n Experts, rate limits orientam o ritmo das chamadas para respeitar o contrato dos serviços integrados.

Conhecer a formação →