Limites de requisição

A API possui um limite de requisições por minuto e por mês.

Por minuto: 60 requisições
Por mês: 5000 requisições

📘

Caso precise de mais requisições, consulte valores com nossa equipe de atendimento.

⏱️ Limite por Minuto (Throttling)

  • Limite: 60 requisições por minuto
  • Aplicado por: API Key

🔄 Comportamento

  • Se excedido, a API responde com HTTP 429 - Too Many Requests.
  • Enquanto o limite estiver excedido, novas requisições continuarão falhando com 429 até que o minuto atual se renove.

✅ Como lidar

  • Implemente controle de taxa no seu sistema:

    • No máximo 60 requisições por minuto por estabelecimento.
    • Distribua as requisições ao longo do tempo para evitar estouros no início do minuto.
  • Em caso de erro 429, adicione um tempo de espera antes de tentar novamente.


📅 Limite Mensal (Quota)

  • Limite: 5.000 requisições por mês (padrão)
  • Aplicado por: API Key

🔒 Comportamento

  • Ao atingir o limite mensal, todas as requisições são bloqueadas com erro HTTP 429 até o início do próximo ciclo (mês seguinte).
  • Não há aviso prévio de que a cota está se esgotando.

✅ Como lidar

  • Monitore a quantidade de chamadas feitas mensalmente (ex: contador local ou log).
  • Evite chamadas desnecessárias (ex: polling excessivo, chamadas duplicadas).
  • Se possível, consolide chamadas em lotes ou cache resultados que não mudam com frequência.

🛠️ Boas práticas adicionais

  • Evite chamadas simultâneas sem controle de volume.
  • Use API Keys distintas por sistema ou cliente para segmentar limites.
  • Se seu volume for maior que os limites, entre em contato para avaliar uma ampliação.