Rate limits
Cuotas, backoff recomendado y patrones de cliente para vivir bien con los rate limits de Routal.
El rate limit global de Routal es 2.000 requests por minuto por credencial, aplicado en todos los endpoints. Excedes y obtienes 429 Too Many Requests.
Patrones recomendados:
- Backoff exponencial con jitter en
429y5xx. Reintentar al instante empeora la cosa. - Endpoints bulk (
POST /v2/stops,POST /v3/vehicles) en vez de loops single-create. - Webhooks en vez de polling — el polling derrocha presupuesto y va con retraso.
- Chunks de 100-250 para imports grandes — fácil de debuggear si una entrada falla.
No se expone hoy el header Retry-After; usa backoff exponencial estándar (250ms · 500ms · 1s · 2s · 4s con jitter).
La referencia completa de rate limits con snippets TS / Python de retry-with-backoff, observability metrics y patrones por endpoint, vive en inglés.