Cómo obtener acceso
Quién puede emitir credenciales, qué ve cada una y cómo se organiza cuando quien integra no es el propio camping.
La documentación es pública; las credenciales, no
Todo lo que estás leyendo se lee sin cuenta: la referencia, la especificación OpenAPI y las guías. Para llamar a la API hace falta una clave, y esa clave la emite el camping desde su panel.El modelo: la clave la emite el recinto
No hay un registro de desarrolladores aparte, ni un proceso de aprobación, ni una revisión de tu aplicación. La razón es que aquí no existe la figura de «aplicación de terceros que pide permiso a muchos usuarios»: cada integración trabaja para un recinto concreto —su cámara, su escáner, su ayuntamiento— y es ese recinto quien decide qué le deja hacer.
Eso tiene una consecuencia práctica que conviene entender: una clave sirve para un recinto y solo uno. Si gestionas varios, tendrás una clave por cada uno.
Quién puede crearlas
Dentro del panel, cualquiera con permiso de configuración —normalmente el propietario o un gestor—. Un recepcionista no ve esta pantalla. Cada alta y cada revocación quedan en el registro de auditoría del camping con nombre y hora.
- Panel → Ajustes → Desarrolladores → Nueva clave.
- Se elige entorno (
pruebasoproducción) y se marcan los permisos. - Opcionalmente, caducidad y las IPs desde las que valdrá.
Si el que integra no es el camping
Es lo habitual: una empresa instaladora, una consultora o el proveedor de un ayuntamiento. Cómo lo recomendamos:
- Una clave por sistema, con su nombre. «Cámara carril entrada», «Portal del Ayuntamiento». Así revocar una no tumba las demás, y en el panel se ve cuál se está usando y cuál lleva un mes muerta.
- Los permisos justos. Una cámara necesita
access:readyaccess:write. Nada más. Si le das lectura de reservas, quien saque la credencial del equipo —que vive en un poste, a la intemperie— se lleva los datos de los huéspedes. - Ata la clave a la IP cuando el sistema tenga dirección fija. Es la diferencia entre que una credencial filtrada sirva desde cualquier parte o no sirva desde ninguna.
- Empieza en pruebas. Se monta contra el recinto de demostración, y cuando funciona se emite la de producción. La clave de pruebas no puede tocar datos reales.
Rotar sin cortar el servicio
Cuando cambies de proveedor, o si sospechas que una clave se ha filtrado, el botón Rotar emite una sucesora con los mismos permisos y deja la anterior viva unos días. Así se despliega la nueva con calma en vez de dejar la barrera muda hasta que alguien suba a la escalera.
Si la filtración es seria, revoca directamente: deja de funcionar en el acto, sin margen.
Si te atascas
Escríbenos a hola@pernocta.app con el X-Request-Id de la respuesta que te dio problemas. Con eso localizamos la petición exacta en nuestros registros, que es bastante más rápido que reconstruir lo que pasó.
