Ir al contenido

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.

Si te pasas, la API responde 429 con el código limite_uso y la cabecera Retry-After:

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-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.

  1. Espera al menos Retry-After segundos. No reintentes antes.
  2. Repite la misma petición. Si lleva Idempotency-Key, usa la misma clave: mira Idempotencia.
  3. Si vuelves a recibir 429, espera más cada vez (espera exponencial con un poco de azar) y pon un máximo de intentos.
  4. 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.

  • Pide listas con limite y cursor en 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.