Primeros pasos

1. Elegí el tipo de clave

Si tu sitio es estático o una SPA, usá una clave pública. Si tenés backend, podés usar la secreta desde ahí, que además puede consultar el estado de una reserva.

2. Creá la clave en el panel

1. Entrá al panel de Turnova con la cuenta de la dueña o de una administradora.
2. Andá a Configuración > API para tu sitio y tocá Nueva clave.
3. Poné un nombre que reconozcas (por ejemplo, «Web del spa»), elegí el tipo y los permisos.
4. Si es pública, cargá el origen de tu sitio tal como lo ve el navegador: https://mi-spa.com (sin barra final ni camino). Para desarrollo vale http://localhost:3000.
5. Copiá la clave: se muestra una sola vez. Turnova guarda solo una huella para reconocerla.

3. Probá la primera llamada

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

Si todo está bien, la respuesta trae ok: true y en datos el nombre del negocio, sus sedes, profesionales y servicios.

Permisos de cada clave

Rotar o dar de baja una clave

Para rotar, creá una clave nueva, cambiala en tu sitio y después revocá la anterior desde el mismo panel. Desde que se revoca, todo pedido con esa clave responde 401 CREDENCIAL_REVOCADA. Pueden convivir varias claves activas.