Rate Limiting

A API pública limita a taxa de requisições por API Key, com um limite único e fixo, sem variação por plano. Esta página é a fonte única sobre o limite, os headers de controle e a resposta 429.

Limite

120 requisições por minuto, contadas por API Key — cada chave tem sua própria janela, independente de outras chaves da mesma empresa. A contagem usa uma janela fixa: ao expirar, o contador zera.

Headers de controle

Toda resposta do grupo público — bem-sucedida ou não — inclui:

Header	Tipo	Descrição
X-RateLimit-Limit	integer	Sempre 120.
X-RateLimit-Remaining	integer	Requisições restantes na janela atual.

Quando o limite é excedido, a resposta 429 adiciona:

Header	Tipo	Descrição
Retry-After	integer	Segundos a aguardar antes de tentar novamente.
X-RateLimit-Reset	integer	Timestamp Unix (segundos) do próximo reset da janela.

Nota

Retry-After e X-RateLimit-Reset aparecem apenas na resposta 429. As demais respostas trazem só X-RateLimit-Limit e X-RateLimit-Remaining.

Exemplo de headers numa resposta dentro do limite:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117

Resposta 429

{
  "message": "Limite de chamadas da API excedido. Tente novamente mais tarde.",
  "data": null
}

A descrição completa de cada código HTTP está em Erros.

Boas práticas

• Verifique X-RateLimit-Remaining antes de disparar um lote grande de chamadas.
• Ao receber 429, respeite Retry-After antes de repetir a requisição, com recuo exponencial em falhas sucessivas.
• Prefira endpoints de listagem com paginação (per_page, até 100) a múltiplas chamadas individuais por {id}.
• O limite é por chave, não por empresa: se você usa várias chaves na mesma empresa (ex.: uma por integração), cada uma tem sua própria cota de 120/min.