→ Abrir en la app — Accede directamente a esta sección desde tu cuenta.
API keys permiten integraciones externas (BI, channel custom, scripts) autenticarse contra la API de Hotelgest sin usuario interactivo. Cada clave tiene descripción, estado activo y permisos acotados al ámbito de la propiedad.
Dónde está
Configuración > API keys — /settings/api-keys
Antes de empezar
Addon API en tu suscripción.
Administrador de la propiedad o permiso Settings-Api en tu rol.
Sin addon verás aviso y botón para contactar ventas.
Tabla
Columnas: Descripción, Creado el, ActivoAcciones:
Crear API key
Documentación — enlace a docs de API
Toggle Activo
Menú por fila: Eliminar (revoca la clave; irreversible)
Crear API key
Modal: campo Descripción de la API key → confirmar.
Tras crear, alerta API key añadida con botón Copiar. El valor completo solo se muestra una vez.
¿Por qué no puedo ver la key después?
Por seguridad, el secreto se almacena hasheado. Si pierdes la key, elimina la antigua y crea una nueva.
Addon API y permisos
Necesitas el addon API activo en la suscripción del hotel y ser administrador o tener permiso Settings-Api. Sin addon, la API rechaza las peticiones aunque guardes una key antigua en tu integración.
Solo veo reservas recientes en la API
Es normal en la primera llamada: la búsqueda devuelve como máximo 20 reservas por petición. Para el histórico completo hay que paginar con offset. Guía: Paginación y límites (pestaña API Reference).
Invalidación de caché al revocar
Al eliminar o deshabilitar, la caché de autenticación por API key se invalida; las integraciones dejan de funcionar en segundos.
Problemas frecuentes
Pantalla con aviso de addon
Contrata el addon API desde Subscripción o contacta ventas.
Soy admin pero no veo Crear API key
Comprueba permiso Settings-Api si tu admin limitó roles, o addon activo.