Límites de uso

Solicitudes por minuto por plan, cabeceras de límite y reintento después de 429.

En esta página

Para que una integración no afecte la operación del almacén, cada empresa tiene un presupuesto de solicitudes por minuto, compartido por todas sus integraciones.

PlanSolicitudes por minutoClientes de integración
Essentials601
Professional3005
EnterpriseSegún contratoSegún contrato

La app de terminales portátiles y el Wizard tienen su propio presupuesto y no consumen el de las integraciones. POST /oauth/token admite 60 solicitudes por minuto por dirección IP.

Cabeceras

CabeceraSignificado
X-RateLimit-LimitSolicitudes permitidas por minuto
X-RateLimit-RemainingSolicitudes restantes en el minuto en curso
Retry-AfterSolo en 429: segundos de espera antes de reintentar

Respuesta 429

  • Espere los segundos de Retry-After y reintente la misma solicitud (con la misma Idempotency-Key si es una escritura).
  • Ante 429, 503 o errores de red, reintente con espera exponencial y variación aleatoria: 1 s, 2 s, 4 s, hasta un máximo.
  • Consulte X-RateLimit-Remaining para reducir el ritmo antes de llegar a cero.
429 Too Many Requests
{
  "error": {
    "code": "rate_limited",
    "message": "Superaste el límite de solicitudes por minuto. Espera los segundos que indica Retry-After.",
    "doc_url": "https://chainlink.mx/developers/errores#rate_limited",
    "request_id": "req_01j9x2m4k7q8r5t6v3w0y1z2a3"
  },
  "errors": [],
  "message": "Superaste el límite de solicitudes por minuto. Espera los segundos que indica Retry-After."
}

Reducción del número de solicitudes

  • Solicite 100 elementos por página (per_page=100).
  • Sincronice por cambios con updated_since en lugar de releer todo.
  • Consulte varios productos en una sola solicitud: GET /stock-levels?item_code=A,B,C.
  • Use webhooks en lugar de consultas periódicas.
  • Para miles de registros, use la carga masiva.