Conecta tu software con los módulos de HMS
Documentación de API independiente para cada módulo del software hotelero: motor de reservas, Wi-Fi para huéspedes, POS de restaurante, spa, TV, PBX y servicios de IA. Las API de Online Booking y Hotspot ya están disponibles; las demás llegarán a continuación.
- Autenticación
- Token
Bearero encabezadoApiKey - Formato
- Respuestas JSON con envoltorio
success - Disponible
- 2 productos · 17 endpoints
- Próximamente
- 5 productos
# Consulta de habitaciones y tarifas
curl "https://test.hms.gen.tr/external/online/roomType" \
-H "Authorization: Bearer $HMS_TOKEN" \
-d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
-d "adultCount=2"# Lista de huéspedes alojados
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"success": true,
"items": [
{
"id": 2,
"name": "Habitación Estándar",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "Alojamiento y desayuno",
"prices": {
"2-1": {
"total": 2,
"price": "1930.00",
"nonRefundable": ""
},
"2-0": {
"total": 2,
"price": "1737.00",
"nonRefundable": "[NR]"
}
}
}
]
}
],
"count": 1
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}Productos
Cada producto tiene su propia documentación, referencia de API y ejemplos de código. Los que están en preparación se anunciarán en el registro de cambios cuando se publiquen.
Online Booking
API del motor de reservas
Conecta el motor de reservas del sitio web del hotel con HMS: lista de habitaciones y tarifas, disponibilidad en calendario, cupones, pago y envío de reservas.
Hotspot
Wi-Fi para huéspedes y registros de la Ley turca n.º 5651
Proporciona al sistema de hotspot la lista de huéspedes alojados: habitación, identidad y horas de check-in y check-out. Sirve para validar el acceso de los huéspedes al Wi-Fi con el número de habitación y para conservar los registros de acceso que exige la Ley turca n.º 5651.
POS de restaurante
Cuentas y cargos a la habitación
Traspaso de las cuentas de restaurante, bar y cafetería al folio de la habitación; sincronización de menú y stock.
Spa
Citas y servicios
Citas de spa y bienestar, catálogo de servicios e integración de cargos a la habitación.
IA
Servicios de asistente y recomendaciones
Acceso a servicios de IA para el asistente del huésped, las recomendaciones de tarifas y los informes.
TV
Sistemas de TV en la habitación
Datos del huésped, folio, mensajes y solicitudes de servicio para la interfaz de TV de la habitación.
PBX
PBX y registros de llamadas
Integración con la centralita telefónica: activación y desactivación de líneas en el check-in/check-out y cargo del importe de las llamadas al folio.
Principios comunes a todos los productos
Cuando hayas integrado un módulo, los demás te resultarán familiares.
Clave vinculada al hotel
En Online Booking, el apiKey/apiSecret emitido por HMS se canjea por un token Bearer vinculado al hotel y válido durante 7 días. Las integraciones locales, como Hotspot, usan una clave generada en el propio panel del hotel, que se envía en el encabezado ApiKey en cada solicitud.
Envoltorio success
Las respuestas son JSON e incluyen el indicador success. Los errores de reglas de negocio se devuelven con HTTP 200 y message o errorCode; los errores de autenticación son 401.
Ejemplos que funcionan
Para cada endpoint se generan ejemplos en cURL, Node.js y PHP; cópialos, añade tu clave y ejecútalos.
Referencia de la APICambios recientes
-
Compatibilidad con 22 idiomasNuevoNuevo
-
Publicada la documentación de la API de HotspotNuevoNuevo
-
Publicada la documentación de la API de Online BookingNuevoNuevoNuevo
¿Necesitas ayuda?
Nuestro equipo de desarrollo responde en un día hábil.
Incluye el cuerpo de la solicitud (con los secretos y los datos de tarjeta enmascarados), la respuesta y la hora. Usa la misma dirección para solicitar claves de partner, hoteles de prueba y acceso anticipado.