Rate limits

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-*:

Header	Significado
`X-RateLimit-Limit` / `RateLimit-Limit`	Limite da chave por minuto.
`X-RateLimit-Remaining` / `RateLimit-Remaining`	Requisições restantes na janela atual.
`X-RateLimit-Reset`	Momento em que a janela reinicia (Unix timestamp, em segundos).
`RateLimit-Reset`	Segundos até a janela reiniciar.
`RateLimit-Policy`	Polí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.

Comece aqui

Conceitos

Quando o limite estoura

Limite da API vs. limite do WhatsApp

​Quando o limite estoura

​Limite da API vs. limite do WhatsApp

Quando o limite estoura

Limite da API vs. limite do WhatsApp