> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quentli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Límites de solicitudes

> Conoce el límite de solicitudes de la API y cómo responder correctamente cuando se alcanza.

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:

```text theme={null}
X-RateLimit-Remaining: 842
```

Cuando alcanzas el límite, Quentli responde con `429 Too Many Requests` e incluye el tiempo de espera recomendado en segundos:

```text theme={null}
Retry-After: 30
```

## 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](/api/idempotencia) para conocer ese comportamiento.

```text theme={null}
1. Recibe 429 y lee Retry-After.
2. Espera el intervalo indicado.
3. Reintenta la misma solicitud.
4. Para POST, PUT, PATCH o DELETE, conserva su X-Idempotency-Key.
```

## 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](mailto:soporte@quentli.com).