Site

Limite de Taxa

Limites de Requisições (Rate Limits) na API

Nossa API possui políticas de limitação de requisições para garantir uso justo e prevenir abusos. É fundamental entender e respeitar esses limites para evitar interrupções no serviço.

Limites Padrão

Os seguintes limites são aplicados por conta:

Ambiente
Limite de Requisições

Produção

20 requisições/segundo

Sandbox

5 requisições/segundo

⚠️ Observação: Esses limites são aplicados por segundo e por conta individual.

Excedendo o Limite (Rate Limit Exceeded)

Se o limite for ultrapassado, a API retornará:

  • Status HTTP 429 Too Many Requests

  • Uma mensagem detalhada no corpo da resposta

Exemplo de resposta:

httpCopyDownload

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "error": "Limite de requisições excedido",
  "message": "Você atingiu o número máximo de requisições por segundo. Se precisar de mais capacidade, entre em contato com nosso suporte."
}

Como Lidar com Erros de Rate Limit

Ao receber um erro 429, recomendamos:

  1. Tentar novamente após uma breve pausa (ex.: 1-2 segundos)

  2. Implementar um algoritmo de exponential back-off (aumentar gradualmente o tempo entre tentativas)

  3. Usar um sistema de filas para distribuir requisições ao longo do tempo

Essas práticas ajudam a evitar bloqueios e mantêm sua aplicação funcionando sem problemas.

Solicitar Aumento de Limite

Se sua aplicação precisar de um limite maior, entre em contato com nosso suporte técnico para avaliar possíveis ajustes.

📌 Ao solicitar, informe:

  • O motivo da necessidade

  • O volume esperado de requisições

  • Casos de uso específicos

Isso nos ajuda a oferecer a melhor solução para seu cenário!

Dica: Monitore suas requisições e ajuste sua lógica de chamadas para evitar atingir os limites inadvertidamente. 🚀

PreviousAutenticaçãoNextWebhook

Last updated