Skip to main content
Cada chave de API tem um limite de requisições por minuto (padrão: 60/min), em janela fixa. Toda resposta autenticada traz o estado atual do seu limite em dois formatos equivalentes — o clássico X-RateLimit-* e o padrão IETF RateLimit-*:
HeaderSignificado
X-RateLimit-Limit / RateLimit-LimitLimite da chave por minuto.
X-RateLimit-Remaining / RateLimit-RemainingRequisições restantes na janela atual.
X-RateLimit-ResetMomento em que a janela reinicia (Unix timestamp, em segundos).
RateLimit-ResetSegundos até a janela reiniciar.
RateLimit-PolicyPolítica da chave no formato limite;w=segundos (ex.: 60;w=60).
A informação de rate limit vem nos headers da resposta, não no corpo. Em ferramentas como o n8n, habilite a opção de incluir headers na resposta (Response → Include Response Headers and Status) para vê-los.

​
Quando o limite estoura

A resposta é 429 rate_limit_exceeded, com o header Retry-After indicando em quantos segundos tentar de novo: 
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit for this API key exceeded. Retry after the time in the Retry-After header.",
    "request_id": "req_1a2b3c4d-..."
  }
}
Trate 429 com backoff: aguarde o Retry-After e repita. Em envios, combine com Idempotency-Key para repetir sem risco de duplicar mensagens.

​
Limite da API vs. limite do WhatsApp

São dois limites diferentes, com códigos distintos:
  • rate_limit_exceeded — sua chave excedeu o limite de requisições da API Superlead.
  • channel_rate_limit — o WhatsApp está limitando o seu número (limites de volume da Meta). Reduza o ritmo de envios para o número; o Retry-After da API não se aplica aqui.
Precisa de um limite maior para a sua operação? Fale com o suporte da Superlead.