Rate Limit

Entenda os limites de requisicoes e como evitar bloqueios.

O que é Rate Limiting?

Rate Limiting e um mecanismo de protecao que limita o numero de requisicoes que um cliente pode fazer em um determinado periodo de tempo. Isso garante a estabilidade da API e protege contra abusos.

Limites Atuais

  1. Requisições por Minuto: 60

  2. Requisições por Dia: 10.000

Headers de Rate Limit

Cada resposta da API inclui headers que informam seu status de rate limit:

  • X-RateLimit-Limit:Número máximo de requisições permitidas no periodo.

  • X-RateLimit-Remaining:Requisições restantes no periodo atual.

  • X-RateLimit-Reset:Timestamp Unix de quando o limite sera resetado.

  • Retry-After:Segundos para aguardar antes de tentar novamente (quando bloqueado).

Resposta de Limite Excedido

Quando o limite e excedido, a API retorna status 429 Too Many Requests:

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 60 
{  
    "type": "https://redefrota.com.br/errors/rate-limit-exceeded",
    "title": "Rate limit excedido",
    "status": 429,
    "detail": "Voce excedeu o limite de 60 requisicoes por minuto. Aguarde 60 segundos."
}

Boas Práticas

  • Implemente retry com backoff exponencial: Aguarde 1s, depois 2s, depois 4s, etc.

  • Monitore os headers: Verifique X-RateLimit-Remaining antes de fazer muitas requisições.

  • Use cache: Armazene respostas que nao mudam frequentemente.

  • Agrupe requisições: Use endpoints de listagem em vez de consultar um por um.

Precisa de Mais?

Se seu caso de uso requer limites maiores, entre em contato com nossa equipe para discutir um plano personalizado.

Falar com Suporte