Rate limits
Para proteger la plataforma, la API aplica límites de frecuencia (rate limiting) por tipo de endpoint. Al superarlos recibes un 429 Too Many Requests.
Cómo funciona
Sección titulada «Cómo funciona»- Los límites se aplican por ventana de tiempo (por ejemplo, X peticiones por minuto).
- Los endpoints sensibles (autenticación, facturación) tienen límites más estrictos que los de lectura.
Manejar un 429
Sección titulada «Manejar un 429»Cuando recibas un 429:
- Espera antes de reintentar.
- Usa backoff exponencial (aumenta el tiempo de espera en cada reintento).
- Evita ráfagas: distribuye las peticiones en el tiempo.
Buenas prácticas
Sección titulada «Buenas prácticas»- Cachea las respuestas que no cambian a menudo en lugar de pedirlas repetidamente.
- Para operaciones masivas, usa los endpoints bulk cuando existan, en vez de muchas peticiones individuales.
- Para reaccionar a eventos, prefiere webhooks / flujos antes que hacer polling constante.