Skip to main content
La API REST de Quentli permite hasta 1,000 solicitudes por minuto desde una misma dirección IP de origen. Las aplicaciones, procesos o usuarios que comparten una IP también comparten este límite.

​
Encabezados de respuesta

Las respuestas permitidas incluyen el número aproximado de solicitudes disponibles:
Cuando alcanzas el límite, Quentli responde con 429 Too Many Requests e incluye el tiempo de espera recomendado en segundos:

​
Cómo reintentar

Cuando recibas 429, espera al menos el número de segundos indicado por Retry-After antes de volver a intentar la solicitud. No reintentes inmediatamente ni envíes solicitudes en paralelo para compensar el rechazo. Para operaciones de escritura, reutiliza también el mismo X-Idempotency-Key en el reintento. Esto evita duplicar una factura, sesión o pago si tu cliente no recibió la respuesta original. Consulta Idempotencia para conocer ese comportamiento.

​
Recomendaciones

  1. Procesa listas paginadas con take y skip en lugar de hacer solicitudes individuales por cada recurso.
  2. Limita la concurrencia de tus trabajos en segundo plano, especialmente cuando sincronices clientes o facturas.
  3. Registra los 429 y el valor de Retry-After para detectar picos de tráfico y ajustar tu ritmo de envío.
  4. Si necesitas un límite mayor para una integración específica, contacta a soporte@quentli.com.