Empezar

API de Turnova

Tomá reservas desde el sitio de tu negocio con el mismo catálogo, la misma agenda y la misma seña que la página de reservas de Turnova.

Ver en Markdown

La API externa permite que un negocio que usa Turnova muestre sus servicios y horarios libres en su propio sitio y tome reservas que entran directo a su agenda. Detrás está el mismo motor que la página de reservas de Turnova: mismos precios, mismas reglas de horario, misma seña por Mercado Pago y los mismos mails de confirmación.

La API está incluida en el plan Enterprise. Las claves se crean en el panel del negocio, en Configuración > API para tu sitio.

Qué podés hacer

Endpoint	Para qué
`GET /api/v1/catalogo`	Servicios, opciones, extras, sedes y profesionales visibles.
`GET /api/v1/disponibilidad`	Horarios libres de un servicio, por día y por profesional.
`POST /api/v1/reservas`	Crear una reserva de uno a ocho turnos, con seña si el negocio la cobra.
`GET /api/v1/reservas/{compraId}`	Estado de una reserva y de su seña (desde tu servidor).

Cómo es una llamada

Todas las rutas cuelgan de https://turnovapp.com/api/v1. El negocio sale de la clave: no hay identificador del negocio en la URL. Toda respuesta es JSON con la misma forma, tanto si salió bien como si no.

curl "https://turnovapp.com/api/v1/catalogo" \
  -H "Authorization: Bearer $TURNOVA_CLAVE_SECRETA"

Por dónde seguir

Primeros pasos: crear la clave y hacer la primera llamada.
Reservar un turno de punta a punta: catálogo, horarios, reserva, seña y vuelta del pago.
Autenticación, Errores, Idempotencia y Límites: las reglas comunes a todos los endpoints.
Guía para agentes de IA: cómo usar esta documentación desde un asistente, con llms.txt.