Rate limits
Cotas, backoff recomendado e padrões de cliente para conviver bem com os rate limits da Routal.
O rate limit global da Routal é 2.000 requisições por minuto por credencial, aplicado em todos os endpoints. Se exceder, recebe 429 Too Many Requests.
Padrões recomendados:
- Backoff exponencial com jitter em
429e5xx. Retentar imediato piora a situação. - Endpoints bulk (
POST /v2/stops,POST /v3/vehicles) em vez de loops single-create. - Webhooks em vez de polling — polling desperdiça orçamento e atrasa eventos.
- Chunks de 100-250 para imports grandes — fácil de debuggar se uma entrada falha.
O header Retry-After não é exposto hoje; use backoff exponencial padrão (250ms · 500ms · 1s · 2s · 4s com jitter).
A referência completa de rate limits com snippets TS / Python de retry-with-backoff, métricas de observability e padrões por endpoint, vive em inglês.