Pular para o conteúdo principal

Rate limiting

A API aplica limite de taxa por requisições.

Limite atual​

ParâmetroValor
Requisições por hora1200
Janela1 hora

Valores configuráveis por ambiente (RateLimiting:RequestsPerHour, RateLimiting:DurationinHours). Confirme o limite vigente do seu ambiente com o time.

Ao exceder​

Requisições além do limite recebem 429 Too Many Requests. Sua integração deve:

  1. Respeitar o código 429 e não reenviar imediatamente.
  2. Aplicar backoff exponencial antes de tentar de novo.
  3. Distribuir chamadas ao longo do tempo, evitando picos.

Boas práticas​

  • Cache respostas que mudam pouco (cadastros, listas de tipos).
  • Use os endpoints de contagem (/count) em vez de baixar listas inteiras para dashboards.
  • Prefira baixa em lote a múltiplas chamadas individuais.