Skip to main content
A iGps aplica limites de requisição para garantir uso justo e estabilidade da API. Quando você excede a taxa de requisições permitida, a API retorna uma resposta 429 Too Many Requests. Este guia explica como detectar erros de limite de requisição e implementar a lógica de retentativa.

Resposta de Limite de Requisição

Quando ocorre um limite de requisição, você recebe um código de status HTTP 429 Too Many Requests. Siga estas etapas quando isso acontecer:
  • Pare de enviar requisições imediatamente: requisições adicionais durante o bloqueio continuarão a falhar.
  • Aguarde antes de tentar novamente: recomenda-se backoff exponencial para evitar sobrecarregar a API assim que a janela for reiniciada.
  • Reenvie a requisição original: assim que passar tempo suficiente, tente a mesma requisição novamente sem modificação.

Backoff Exponencial

O backoff exponencial é uma estratégia padrão de retentativa que dobra o tempo de espera após cada tentativa falha, reduzindo a pressão sobre a API e dando à sua integração a melhor chance de eventualmente ter sucesso.

Reduzindo o Volume de Requisições

Reduzir proativamente o número de requisições que você faz é a melhor forma de se manter dentro dos limites:
  • Faça cache dos resultados para o intervalo de polling relevante para o seu caso de uso (por exemplo, 30 segundos para rastreamento quase em tempo real). Evite consultar novamente dados que ainda não tiveram tempo de mudar.
  • Use consultas em lote (até 50 por requisição) em vez de enviar uma requisição por veículo.
  • Evite loops de polling apertados: introduza um sleep entre requisições sucessivas para regular sua integração.
Agrupar até 50 veículos por requisição é a maneira mais eficaz de reduzir o volume total de chamadas à API.