Autenticación
Una clave por integración, con los permisos justos y revocable en cualquier momento.
curl https://pernocta.app/api/v1/ping \
-H "Authorization: Bearer pna_live_TU_CLAVE"Las claves
Se crean en Ajustes › API e integraciones. El token tiene 240 bits de aleatoriedad y empieza por pna_live_ o pna_test_ según el entorno.
No guardamos tu clave
Solo guardamos su huella criptográfica y los primeros caracteres, para que puedas reconocerla en el panel. Ni nosotros podemos recuperarla: si se pierde, se revoca y se emite otra.Una clave puede llevar fecha de caducidad. Al revocarla deja de funcionar en el acto —no hay caché ni margen de gracia— y la fila se conserva: quién tuvo acceso y hasta cuándo es parte de la auditoría.
Permisos
No hay comodines ni herencia: access:write no implica access:read. Es deliberadamente aburrido, porque la sorpresa en un control de acceso siempre juega en contra.
| Permiso | Da acceso a |
|---|---|
| reservations:read | Leer reservas, disponibilidad y catálogo de plazas. |
| reservations:write | Crear reservas y marcar entrada, salida o cancelación. |
| travelers:write | Volcar viajeros a la ficha (escáner documental). |
| access:read | Descargar la lista blanca de matrículas, las puertas y el histórico de accesos. |
| access:write | Notificar matrículas leídas y abrir la barrera. |
| billing:read | Facturas emitidas y cobros, para contabilidad. |
| customers:read | Clientes con su historial de estancias y su deuda. |
| charges:write | Cargar tickets de un TPV externo a la cuenta de una reserva (el bar o el restaurante). |
access:read y access:write, y nada más. Si le das reservations:read, cualquiera que consiga sacar la clave del equipo —que vive a la intemperie, en un poste— podrá leer los datos personales de tus huéspedes.Aislamiento entre recintos
El camping se deduce siempre de la credencial. Ningún endpoint acepta un identificador de camping como parámetro, así que no existe la petición «dame los datos de ese otro». Una reserva que no sea del recinto de tu clave devuelve 404, igual que si no existiera: tampoco confirmamos su existencia.
Entorno de pruebas
Las claves pna_test_ apuntan a un recinto de demostración con datos ficticios. Se pueden crear reservas, escanear documentos, simular matrículas y abrir una barrera simulada sin tocar hardware real ni datos de personas.
Escríbenos a hola@pernocta.app con el caso que quieres montar y te preparamos las credenciales y los datos de ejemplo el mismo día.
Buenas prácticas
- Una clave por integración, no una compartida por todas: revocar la de una cámara no debe tumbar el resto.
- Nunca en el código fuente ni en el repositorio. Variable de entorno o gestor de secretos.
- Rotación: crea la nueva, cambia el consumidor, revoca la vieja. En ese orden y sin prisa.
- La clave nunca en el navegador de un usuario final: la API se llama desde tu servidor o desde el equipo.