Operativa diaria
Desarrolladores (API e integraciones)
Claves de API y webhooks para que un sistema externo lea tus reservas o abra la barrera.
Ajustes › Desarrolladores es donde das acceso a un sistema que no es Pernocta: la cámara que lee matrículas en la entrada, un escáner de documentos de otra marca o el software de un ayuntamiento o una empresa gestora. Si no vas a conectar nada externo, puedes ignorar esta pantalla entera.
Claves de API
Una clave es la contraseña con la que ese sistema se identifica. Al crearla eliges qué puede hacer: leer reservas, registrar viajeros, consultar las matrículas autorizadas o abrir la barrera. Da solo lo que necesite —una cámara de matrículas no tiene por qué poder leer los datos personales de tus huéspedes— y revócala en cuanto dejes de trabajar con ese proveedor.
La clave se enseña UNA sola vez, al crearla. No la guardamos: solo guardamos una huella suya para reconocerla. Si se pierde no hay forma de recuperarla, se revoca y se crea otra.
Webhooks
Un webhook es una dirección tuya a la que avisamos cada vez que pasa algo: una reserva confirmada, un check-in completado, un pago recibido o una apertura de barrera. Así el otro sistema se entera al momento en vez de estar preguntando. Cada envío va firmado para que tu servidor pueda comprobar que viene de nosotros, y si tu servidor está caído lo reintentamos durante unas horas. En la misma pantalla ves el historial de envíos con la respuesta que dio cada uno.
Cámaras de matrículas
Se configuran en Ajustes › Accesos › Cámaras de matrículas, no aquí. Allí se da de alta el equipo y se obtiene la dirección que hay que pegar en su configuración para que nos avise de cada lectura.
La documentación técnica completa, con ejemplos y una consola para probar, está publicada en pernocta.app/developers. Pásasela a quien vaya a hacer la integración.
