Skip to main content
Esta página describe, de forma factual, los límites de solicitud que la API de Nuvia aplica hoy. Para autenticar sus llamadas, consulte Autenticación.

​
API REST (llamadas con API key)

Actualmente no hay límite de solicitudes por ruta aplicado a las llamadas autenticadas por API key. No publicamos un número de solicitudes por segundo o por minuto para la API REST principal porque no existe un límite de ese tipo vigente.
Aunque no haya límite por ruta hoy, diseñe su integración para ser resiliente: trate las respuestas 429 Too Many Requests con reintento y backoff exponencial. Así, si se aplican límites en el futuro, su código ya los maneja sin cambios.

​
Límites que existen hoy

Algunos flujos específicos tienen un límite aplicado. Responden 429 Too Many Requests con el cuerpo:
Estas respuestas 429 no incluyen headers de límite de uso: no hay X-RateLimit-Limit, X-RateLimit-Remaining ni Retry-After. No dependa de estos headers para decidir cuándo reintentar la solicitud; use su propia estrategia de backoff.

​
Recomendación

1

Implemente reintento con backoff

Al recibir 429, espere antes de reintentar y aumente el intervalo en cada nuevo intento (backoff exponencial), con un tope de intentos.
2

No dependa de headers de límite

Como las respuestas 429 no traen headers de límite de uso, base el backoff en su propio control de tiempo, no en valores retornados por la API.