Beta privada · apertura 23 de diciembre
Límites y error 429
Para que la API responda bien a todos, limitamos cuántas peticiones puedes hacer seguidas. Los límites numéricos por clave están por confirmar; programa tu cliente para respetar la señal de la API en lugar de depender de una cifra.
El error 429
Sección titulada «El error 429»Si te pasas, la API responde 429 con el código limite_uso y la cabecera Retry-After:
HTTP/1.1 429 Too Many RequestsRetry-After: 12X-Request-Id: req_8f2c1a7d{ "error": { "codigo": "limite_uso", "mensaje": "Hiciste demasiadas peticiones seguidas. Espera los segundos que indica `Retry-After` y vuelve a intentar.", "request_id": "req_8f2c1a7d", "docs": "https://docs.opennexum.com/errores#limite_uso" }}Retry-After son los segundos que debes esperar antes de volver a intentar.
Cómo reintentar
Sección titulada «Cómo reintentar»- Espera al menos
Retry-Aftersegundos. No reintentes antes. - Repite la misma petición. Si lleva
Idempotency-Key, usa la misma clave: mira Idempotencia. - Si vuelves a recibir 429, espera más cada vez (espera exponencial con un poco de azar) y pon un máximo de intentos.
- Reparte tus llamadas en el tiempo en lugar de lanzarlas todas juntas.
También usan Retry-After los errores no_disponible (HTTP 503), cuando un dato todavía se está cargando de nuestro lado.
Cómo reducir las peticiones
Sección titulada «Cómo reducir las peticiones»- Pide listas con
limiteycursoren lugar de consultar uno por uno. - Guarda lo que cambia poco, como un RUC o el tipo de cambio del día.
- En Nexum Conecta, recibe los eventos por webhook en lugar de consultar la bandeja cada pocos segundos.