Rate limiting

Rate limiting

Limite de 60 req/min por API key. Cabeçalho Retry-After e erro 429 RATE_LIMITED.

Aplica-se a todas as chamadas autenticadas. A granularidade é por API key, por minuto UTC.

ItemValor
Limite padrão60 req/min (configurável no servidor via API_RATE_LIMIT_PER_MINUTE)
JanelaMinuto UTC (ex.: 2026-06-09T12:01)

Ao exceder (429)

{ "error": "Limite de requisições excedido", "code": "RATE_LIMITED" }

A resposta inclui o header Retry-After: <segundos até a próxima janela>.

HTTP code Quando
429 RATE_LIMITED Cota por minuto da chave excedida (+ Retry-After)

Além do rate limit por chave, o WhatsApp/Meta tem o próprio limite (ver META_RATE_LIMIT) e o cap diário por tier (ver Tiers).

Pular para o conteúdo