Настанени гости

Единственият ресурс на hotspot интеграцията. Връща данни за стаята, самоличността и настаняването/напускането за всеки гост, който в момента е в хотела (настанен и все още не е напуснал). Hotspot софтуерът изтегля този списък на редовни интервали и според него отваря или затваря Wi-Fi акаунтите; стъпките са описани в ръководството Процес на проверка на гостите.

POST/public/json/customer/inhotelСписък с настанените гости

Обект#

Полета

uniqueinteger

ID на престоя, уникален за всеки гост и резервация. Използвайте го като ключ на потребителя / сесията от страна на hotspot системата.

rezervasyon_idinteger

ID на резервацията. Гостите в една стая имат една и съща стойност.

inHotelinteger

1 = гостът е настанен в хотела. Винаги е 1, тъй като крайната точка връща само настанени гости.

firstNamestring

Име. Обикновено с главни букви, както е прочетено от документа за самоличност; няколко имена се разделят с интервал.

lastNamestring

Фамилия. Обикновено с главни букви.

identityNumberstring | null

Турски национален идентификационен номер или номер на паспорт, както е изписан в документа. Може да е празно при гости, регистрирани без данни за самоличност.

birthDatestring | null

Дата на раждане, DD.MM.YYYY. Може да е празно.

roomIDinteger

HMS ID на стаята.

roomNamestring

Име / номер на стаята, както гостът го вижда на вратата и на ключ-картата. Питайте за тази стойност като „номер на стая“ в портала.

checkininteger

Час на настаняване на госта като Unix времеви печат (секунди).

checkoutinteger

Планирана дата на напускане като Unix времеви печат в началото на деня (00:00 UTC); не съдържа час. Добавете часа за напускане на хотела (обикновено 12:00), за да получите края на сесията.

checkout2integer | null

Действителен час на напускане. null за настанените гости; гост, който напусне, така или иначе отпада от списъка.

mikrotikSifrelemeinteger

Настройката за криптиране на Mikrotik за сградата на стаята в HMS: 0 име на стаята (паролата за Wi-Fi е номерът на стаята), 1 без парола. Прилагайте същата политика в собствения си портал.

01

Примерен обект

{
    "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
}

Списък с настанените гости#

POST/public/json/customer/inhotel

Удостоверяване: Заглавка ApiKey

Връща пълния списък с настанените гости. Няма параметри за филтриране и няма тяло на заявката. Гостът се появява в списъка, когато резервацията е активна, настаняването е извършено, а напускането — още не, и гостът е отбелязан като „в хотела“. Всеки гост от една и съща резервация е отделен запис.

Отговорът не се разделя на страници; при големите хотели може да съдържа няколкостотин записа. Кеширайте списъка и го опреснявайте на препоръчания интервал.

Заглавки

ApiKeystringзадължително

Специален API ключ (Custom API), генериран в административния панел на HMS. Обвързан е с един хотел, който определя чии гости се показват.

HotelCodeinteger

HMS ID на хотела. Не се използва за валидация, тъй като сървърът определя хотела по ключа; препоръчва се за логване и съвместимост.

Отговор

200 success: 1 и масивът otelde. Ако в хотела няма гости, масивът е празен; това не е грешка.

successinteger

1 успех, 0 неуспех. Число, а не булева стойност, както е в Online Booking.

otelde[]object[]

Записи за гостите. За полетата вижте раздела Обект по-горе.

Отговори при грешка

401 Заглавката ApiKey липсва, празна е или ключът не е дефиниран в HMS (може да е изтрит). Тяло: {"success": 0}.
405 Заявката е изпратена с метод, различен от POST (например GET от адресната лента на браузъра).

Заявка

curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
  -H "ApiKey: $HMS_API_KEY" \
  -H "HotelCode: 1000"

const res = await fetch("https://test.hms.gen.tr/public/json/customer/inhotel", {
  method: "POST",
  headers: {
    "ApiKey": process.env.HMS_API_KEY,
    "HotelCode": "1000"
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/public/json/customer/inhotel');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'ApiKey: ' . getenv('HMS_API_KEY'),
        'HotelCode: 1000',
    ],
]);
$data = json_decode(curl_exec($ch), true);

Отговор · 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
        }
    ]
}

Отговор · 200 (няма настанени гости)

{
    "success": 1,
    "otelde": []
}

Отговор · 401 (невалиден ключ)

{
    "success": 0
}

Последна актуализация: 21 септември 2026 г.Открихте грешка? Пишете ни