Oteldeki misafirler

Hotspot entegrasyonunun tek kaynağı. Şu anda otelde bulunan (check-in yapılmış, henüz çıkış yapmamış) her misafir için oda, kimlik ve giriş-çıkış bilgisini döner. Hotspot yazılımı bu listeyi düzenli aralıklarla çekip Wi-Fi hesaplarını buna göre açar ve kapatır; adımlar Misafir doğrulama akışı rehberinde anlatılır.

POST/public/json/customer/inhotelOteldeki misafir listesi

Nesne#

Alanlar

uniqueinteger

Konaklama hareketi kimliği; her misafir ve rezervasyon için tekildir. Hotspot tarafında kullanıcı / oturum anahtarı olarak bunu kullanın.

rezervasyon_idinteger

Rezervasyon kimliği. Aynı odada kalan misafirler aynı değeri paylaşır.

inHotelinteger

1 = misafir otelde. Uç nokta yalnızca oteldeki misafirleri döndürdüğünden her zaman 1 gelir.

firstNamestring

Ad. Kimlik belgesinden okunduğu için genellikle büyük harftir; birden fazla ad boşlukla ayrılır.

lastNamestring

Soyad. Genellikle büyük harf.

identityNumberstring | null

T.C. kimlik numarası ya da pasaport numarası, belgede yazdığı gibi. Kimlik bilgisi girilmeden kaydedilen misafirlerde boş olabilir.

birthDatestring | null

Doğum tarihi, GG.AA.YYYY. Boş olabilir.

roomIDinteger

Odanın HMS kimliği.

roomNamestring

Oda adı / numarası; misafirin kapıda ve kartında gördüğü değer. Portalda “oda numarası” olarak bunu sorun.

checkininteger

Misafirin giriş zamanı, Unix zaman damgası (saniye).

checkoutinteger

Planlanan çıkış tarihi, Unix zaman damgası. Günün başlangıcıdır (00:00 UTC) ve saat bilgisi taşımaz; oturum sonu için otelin çıkış saatini (genellikle 12:00) ekleyin.

checkout2integer | null

Fiili çıkış zamanı. Oteldeki misafirlerde null; misafir çıkış yaptığında zaten listeden düşer.

mikrotikSifrelemeinteger

Odanın bulunduğu binanın HMS’deki Mikrotik şifreleme ayarı: 0 oda adı (Wi-Fi parolası oda numarasıdır), 1 şifresiz (parola sorulmaz). Kendi portalınızda aynı politikayı uygulayın.

01

Örnek nesne

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

Oteldeki misafir listesi#

POST/public/json/customer/inhotel

Kimlik doğrulama: ApiKey başlığı

Oteldeki misafirlerin tam listesini döner. Filtre parametresi yoktur ve gövde gönderilmez. Bir misafirin listeye girmesi için rezervasyonun aktif olması, rezervasyona check-in yapılmış ve çıkış yapılmamış olması, misafirin “otelde” işaretli olması gerekir. Aynı rezervasyondaki her misafir ayrı bir kayıttır.

Yanıt sunucu tarafında sayfalanmaz; büyük otellerde birkaç yüz kayıt dönebilir. Listeyi önbelleğe alın ve önerilen aralıkta yenileyin.

Başlıklar

ApiKeystringzorunlu

HMS yönetim panelinde üretilen özel API anahtarı. Otele bağlıdır; hangi otelin misafirlerinin listeleneceğini bu anahtar belirler.

HotelCodeinteger

Otelin HMS kimliği. Sunucu oteli anahtardan bulduğu için doğrulamada kullanılmaz; günlükleme ve uyumluluk için gönderilmesi önerilir.

Yanıt

200 success: 1 ve otelde dizisi. Otelde misafir yoksa dizi boş döner; bu bir hata değildir.

successinteger

1 başarılı, 0 başarısız. Online Booking’den farklı olarak boolean değil sayıdır.

otelde[]object[]

Misafir kayıtları. Alanlar için yukarıdaki Nesne bölümüne bakın.

Hata yanıtları

401 ApiKey başlığı yok, boş ya da anahtar HMS’de tanımlı değil (silinmiş olabilir). Gövde: {"success": 0}.
405 İstek POST dışında bir yöntemle gönderildi (ör. tarayıcı adres çubuğundan GET).

İstek

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

Yanıt · 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
        }
    ]
}

Yanıt · 200 (otelde misafir yok)

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

Yanıt · 401 (anahtar geçersiz)

{
    "success": 0
}

Son güncelleme: 8 Eylül 2026Bu sayfada bir hata mı var? Bize yazın