# Límites

> Cuántos pedidos por minuto acepta cada clave y qué hacer al pasarse.

Los límites se cuentan por clave en ventanas de un minuto. Son iguales para todos los negocios con la API.

| Qué | Límite |
| --- | --- |
| Lecturas (catálogo, disponibilidad, estado de una reserva) | 120 por minuto por clave |
| Escrituras (crear reservas) | 20 por minuto por clave |
| Escrituras con clave pública, por IP de la clienta | 6 por minuto |

Al pasarse, la respuesta es `429 LIMITE_USO` con la cabecera `Retry-After` (segundos) y `reintentable: true`. Esperá ese tiempo y repetí el pedido; si era una reserva, con la misma `Idempotency-Key`.

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 23
Content-Type: application/json
```

## Buenas prácticas

- Leé el catálogo una vez por visita (o cachealo en tu servidor unos minutos): cambia poco.
- Pedí disponibilidad cuando la clienta elige el servicio, no en cada render. Con `dias` traés varios días en un solo pedido.
- La disponibilidad ya viene cacheada hasta 45 segundos del lado de Turnova: pedirla más seguido no trae datos más nuevos. Ver [Disponibilidad y caché](https://turnovapp.com/docs/disponibilidad-y-cache.md).

## Uso de tus claves

En el panel, **Configuración > API para tu sitio** muestra por día y por clave cuántas lecturas, escrituras, reservas creadas y rechazos por límite hubo.