TurnovaAPIPanel

Conceptos

Límites

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

Ver en Markdown

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 clienta6 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/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é.

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.