Huéspedes alojados

El único recurso de la integración de hotspot. Devuelve la habitación, la identidad y los datos de check-in y check-out de cada huésped alojado en este momento (con el check-in hecho y sin check-out todavía). El software de hotspot obtiene esta lista a intervalos regulares y abre o cierra las cuentas de Wi-Fi en consecuencia; los pasos se describen en la guía Flujo de verificación de huéspedes.

POST/public/json/customer/inhotelLista de huéspedes alojados

Objeto#

Campos

uniqueinteger
ID del registro de estancia, único por huésped y reserva. Úsalo como clave de usuario o de sesión en el sistema de hotspot.
rezervasyon_idinteger
ID de la reserva. Los huéspedes que comparten habitación tienen el mismo valor.
inHotelinteger
1 = el huésped está alojado. Siempre vale 1, ya que el endpoint solo devuelve huéspedes alojados.
firstNamestring
Nombre. Normalmente en mayúsculas, tal como se lee en el documento de identidad; si hay varios nombres, van separados por espacios.
lastNamestring
Apellido. Normalmente en mayúsculas.
identityNumberstring | null
Número de identidad nacional turco o número de pasaporte, tal como figura en el documento. Puede estar vacío en huéspedes registrados sin datos de identidad.
birthDatestring | null
Fecha de nacimiento, DD.MM.YYYY. Puede estar vacía.
roomIDinteger
ID de la habitación en HMS.
roomNamestring
Nombre o número de la habitación tal como lo ve el huésped en la puerta y en la tarjeta llave. Es lo que debes pedir como “número de habitación” en el portal.
checkininteger
Hora de check-in del huésped, como marca de tiempo Unix (segundos).
checkoutinteger
Fecha de salida prevista, como marca de tiempo Unix al inicio del día (00:00 UTC); no incluye la hora. Suma la hora de check-out del hotel (normalmente las 12:00) para obtener el fin de la sesión.
checkout2integer | null
Hora real de check-out. null para los huéspedes alojados; de todos modos, un huésped que hace el check-out desaparece de la lista.
mikrotikSifrelemeinteger
Configuración de cifrado de Mikrotik del edificio de la habitación en HMS: 0 nombre de la habitación (la contraseña del Wi-Fi es el número de habitación), 1 sin contraseña. Aplica la misma política en tu propio portal.
01
Objeto de ejemplo
{
    "mikrotikSifreleme": 0,
    "unique": 58211,
    "inHotel": 1,
    "identityNumber": "11111111110",
    "firstName": "AYŞE",
    "lastName": "DEMİR",
    "birthDate": "14.03.1985",
    "roomID": 4,
    "roomName": "104",
    "checkin": 1788863400,
    "checkout": 1788998400,
    "checkout2": null,
    "rezervasyon_id": 282799
}

Lista de huéspedes alojados#

POST/public/json/customer/inhotel

Autenticación: Encabezado ApiKey

Devuelve la lista completa de huéspedes alojados. No hay parámetros de filtro ni cuerpo de solicitud. Un huésped aparece en la lista cuando la reserva está activa, tiene el check-in hecho y aún no el check-out, y el huésped está marcado como “alojado”. Cada huésped de una misma reserva es un registro independiente.

La respuesta no está paginada; en hoteles grandes puede devolver varios cientos de registros. Guarda la lista en caché y actualízala con el intervalo recomendado.

Encabezados

ApiKeystringobligatorio
Clave de API personalizada generada en el panel de administración de HMS. Está vinculada a un hotel, que determina de qué huéspedes se obtiene la lista.
HotelCodeinteger
ID del hotel en HMS. No se usa para la validación, ya que el servidor identifica el hotel a partir de la clave; se recomienda enviarlo por motivos de registro y compatibilidad.

Respuesta

200 success: 1 y el array otelde. Si no hay nadie alojado, el array está vacío; eso no es un error.

successinteger
1 éxito, 0 error. Es un número, no un booleano como en Online Booking.
otelde[]object[]
Registros de huéspedes. Consulta la sección Objeto más arriba para ver los campos.

Respuestas de error

  • 401 El encabezado ApiKey falta, está vacío o la clave no está definida en HMS (puede que se haya eliminado). Cuerpo: {"success": 0}.
  • 405 La solicitud usó un método distinto de POST (por ejemplo, GET desde la barra de direcciones del navegador).
Solicitud
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
  -H "ApiKey: $HMS_API_KEY" \
  -H "HotelCode: 1000"
Respuesta · 200
{
    "success": 1,
    "otelde": [
        {
            "mikrotikSifreleme": 0,
            "unique": 58211,
            "inHotel": 1,
            "identityNumber": "11111111110",
            "firstName": "AYŞE",
            "lastName": "DEMİR",
            "birthDate": "14.03.1985",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "checkout2": null,
            "rezervasyon_id": 282799
        },
        {
            "mikrotikSifreleme": 0,
            "unique": 58212,
            "inHotel": 1,
            "identityNumber": "22222222220",
            "firstName": "MEHMET",
            "lastName": "DEMİR",
            "birthDate": "02.11.1982",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "checkout2": null,
            "rezervasyon_id": 282799
        },
        {
            "mikrotikSifreleme": 0,
            "unique": 58197,
            "inHotel": 1,
            "identityNumber": "U01234567",
            "firstName": "JULIA",
            "lastName": "WAGNER",
            "birthDate": "27.06.1990",
            "roomID": 12,
            "roomName": "205",
            "checkin": 1788782700,
            "checkout": 1789084800,
            "checkout2": null,
            "rezervasyon_id": 282803
        }
    ]
}
Respuesta · 200 (sin huéspedes alojados)
{
    "success": 1,
    "otelde": []
}
Respuesta · 401 (clave no válida)
{
    "success": 0
}
Última actualización: 21 de septiembre de 2026¿Has encontrado un error? Avísanos