Límites de tasa
Los límites de tasa mantienen predecible el rendimiento del tenant. Se aplican por API key en una ventana fija de 60 segundos.
Niveles
| Nivel | Peticiones / minuto |
|---|---|
standard (predeterminado) | 120 |
elevated | 600 |
El nivel de tu key y el presupuesto actual se informan en GET /v1/auth/context (rate_limit_tier) y GET /v1/usage (rate_limit.limit_per_minute y rate_limit.remaining_per_minute). Lee siempre los valores en vivo en lugar de codificarlos de forma fija.
Cuando superas el límite
Las peticiones que superan el límite devuelven 429 con code: "RATE_LIMITED". Aplica un retroceso y reintenta después de que se restablezca la ventana.
Diseñar dentro de los límites
- Almacena en caché los datos de referencia y prefiere las sincronizaciones incrementales antes que el sondeo de tablas completas.
- Usa webhooks para actualizaciones basadas en eventos en lugar de sondear.
- Aplica un retroceso ante
429y evita tormentas de reintentos en paralelo tras fallos transitorios. - Combina filtros (
search,status,module) para obtener menos datos.