Oteldə qalan qonaqlar

Hotspot inteqrasiyasının yeganə resursu. Hazırda oteldə olan (check-in edilmiş, hələ check-out etməmiş) hər qonaq üçün otaq, şəxsiyyət və check-in/check-out məlumatlarını qaytarır. Hotspot proqramı bu siyahını müntəzəm aralıqlarla alır və Wi-Fi hesablarını ona uyğun olaraq açıb-bağlayır; addımlar Qonaq yoxlaması axını bələdçisində təsvir olunub.

POST/public/json/customer/inhotelOteldə qalan qonaqların siyahısı

Obyekt#

Sahələr

uniqueinteger

Qalma qeydinin ID-si; hər qonaq və rezervasiya üçün unikaldır. Hotspot tərəfində istifadəçi / sessiya açarı kimi bundan istifadə edin.

rezervasyon_idinteger

Rezervasiya ID-si. Eyni otaqda qalan qonaqlarda bu dəyər eynidir.

inHotelinteger

1 = qonaq oteldədir. Son nöqtə yalnız oteldə qalan qonaqları qaytardığı üçün həmişə 1 olur.

firstNamestring

Ad. Şəxsiyyət sənədindən oxunduğu üçün adətən böyük hərflərlə yazılır; bir neçə ad boşluqla ayrılır.

lastNamestring

Soyad. Adətən böyük hərflərlə yazılır.

identityNumberstring | null

Türkiyə şəxsiyyət nömrəsi və ya pasport nömrəsi, sənəddə yazıldığı kimi. Şəxsiyyət məlumatları daxil edilmədən qeydiyyata alınan qonaqlarda boş ola bilər.

birthDatestring | null

Doğum tarixi, DD.MM.YYYY. Boş ola bilər.

roomIDinteger

Otağın HMS ID-si.

roomNamestring

Otağın adı / nömrəsi — qonağın qapıda və açar kartında gördüyü kimi. Portalda “otaq nömrəsi” kimi məhz bunu soruşun.

checkininteger

Qonağın check-in vaxtı, Unix vaxt damğası (saniyə).

checkoutinteger

Planlaşdırılan çıxış tarixi, günün başlanğıcına (00:00 UTC) uyğun Unix vaxt damğası; saat məlumatı daşımır. Sessiyanın bitmə vaxtını almaq üçün otelin check-out saatını (adətən 12:00) əlavə edin.

checkout2integer | null

Faktiki check-out vaxtı. Oteldə qalan qonaqlar üçün null; check-out edən qonaq onsuz da siyahıdan çıxır.

mikrotikSifrelemeinteger

Otağın yerləşdiyi binanın HMS-dəki Mikrotik şifrələmə ayarı: 0 otaq adı (Wi-Fi parolu otaq nömrəsidir), 1 parolsuz. Öz portalınızda da eyni siyasəti tətbiq edin.

01

Nümunə obyekt

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

Oteldə qalan qonaqların siyahısı#

POST/public/json/customer/inhotel

Autentifikasiya: ApiKey başlığı

Oteldə qalan qonaqların tam siyahısını qaytarır. Filtr parametrləri və sorğu gövdəsi yoxdur. Qonaq siyahıda o halda görünür ki, rezervasiya aktivdir, check-in edilib, hələ check-out edilməyib və qonaq “oteldə” kimi işarələnib. Eyni rezervasiyanın hər qonağı ayrıca qeyddir.

Cavab səhifələnmir; böyük otellərdə bir neçə yüz qeyd qayıda bilər. Siyahını keşləyin və tövsiyə olunan intervalla yeniləyin.

Başlıqlar

ApiKeystringməcburi

HMS idarəetmə panelində yaradılan xüsusi API açarı. Bir otelə bağlıdır və hansı otelin qonaqlarının siyahıya alınacağını müəyyən edir.

HotelCodeinteger

Otelin HMS ID-si. Server oteli açara görə müəyyən etdiyi üçün yoxlamada istifadə olunmur; loqlama və uyğunluq üçün göndərilməsi tövsiyə olunur.

Cavab

200 success: 1 və otelde massivi. Oteldə heç kim yoxdursa, massiv boş olur; bu, xəta deyil.

successinteger

1 uğurlu, 0 uğursuz. Online Booking-dəki kimi boolean deyil, rəqəmdir.

otelde[]object[]

Qonaq qeydləri. Sahələr üçün yuxarıdakı Obyekt bölməsinə baxın.

Xəta cavabları

401 ApiKey başlığı yoxdur, boşdur və ya HMS-də təyin edilməyib (silinmiş ola bilər). Gövdə: {"success": 0}.
405 Sorğu POST deyil, başqa metodla göndərilib (məsələn, brauzerin ünvan sətrindən GET).

Sorğu

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);

Cavab · 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
        }
    ]
}

Cavab · 200 (oteldə qonaq yoxdur)

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

Cavab · 401 (yanlış açar)

{
    "success": 0
}

Son yenilənmə: 21 sentyabr 2026Səhv tapdınız? Bizə bildirin