Tamu yang sedang menginap

Satu-satunya sumber daya integrasi hotspot. Mengembalikan detail kamar, identitas, serta check-in/check-out untuk setiap tamu yang saat ini sedang menginap (sudah check-in, belum check-out). Perangkat lunak hotspot mengambil daftar ini secara berkala, lalu membuka atau menutup akun Wi-Fi sesuai daftar tersebut; langkah-langkahnya dijelaskan dalam panduan Alur verifikasi tamu.

POST/public/json/customer/inhotelDaftar tamu yang sedang menginap

Objek#

Field

uniqueinteger

ID data menginap, unik untuk setiap tamu dan reservasi. Gunakan sebagai kunci pengguna / sesi di sisi hotspot.

rezervasyon_idinteger

ID reservasi. Tamu yang berbagi kamar memiliki nilai yang sama.

inHotelinteger

1 = tamu sedang menginap. Selalu 1, karena endpoint hanya mengembalikan tamu yang sedang menginap.

firstNamestring

Nama depan. Biasanya huruf kapital, sesuai yang terbaca dari dokumen identitas; beberapa nama depan dipisahkan dengan spasi.

lastNamestring

Nama belakang. Biasanya huruf kapital.

identityNumberstring | null

Nomor identitas nasional Turki atau nomor paspor, sesuai yang tertera di dokumen. Bisa kosong untuk tamu yang didaftarkan tanpa detail identitas.

birthDatestring | null

Tanggal lahir, DD.MM.YYYY. Bisa kosong.

roomIDinteger

ID HMS kamar.

roomNamestring

Nama / nomor kamar seperti yang dilihat tamu di pintu dan kartu kunci. Mintalah nilai ini sebagai “nomor kamar” di portal.

checkininteger

Waktu check-in tamu dalam Unix timestamp (detik).

checkoutinteger

Tanggal check-out yang direncanakan dalam Unix timestamp pada awal hari (00:00 UTC); tidak memuat jam. Tambahkan jam check-out hotel (biasanya 12:00) untuk mendapatkan akhir sesi.

checkout2integer | null

Waktu check-out aktual. null untuk tamu yang sedang menginap; tamu yang sudah check-out otomatis hilang dari daftar.

mikrotikSifrelemeinteger

Pengaturan enkripsi Mikrotik untuk gedung kamar tersebut di HMS: 0 nama kamar (kata sandi Wi-Fi adalah nomor kamar), 1 tanpa kata sandi. Terapkan kebijakan yang sama di portal Anda sendiri.

01

Contoh objek

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

Daftar tamu yang sedang menginap#

POST/public/json/customer/inhotel

Autentikasi: Header ApiKey

Mengembalikan daftar lengkap tamu yang sedang menginap. Tidak ada parameter filter dan tidak ada body permintaan. Tamu muncul dalam daftar jika reservasinya aktif, sudah check-in dan belum check-out, serta tamu tersebut ditandai “sedang menginap”. Setiap tamu dalam reservasi yang sama merupakan record terpisah.

Respons tidak dipaginasi; hotel besar dapat mengembalikan beberapa ratus record. Simpan daftar di cache dan perbarui pada interval yang disarankan.

Header

ApiKeystringwajib

Kunci API khusus yang dibuat di panel admin HMS. Kunci ini terikat ke satu hotel, dan hotel itulah yang menentukan tamu mana yang ditampilkan.

HotelCodeinteger

ID HMS hotel. Tidak digunakan untuk validasi karena server menentukan hotel dari kunci; tetap disarankan untuk logging dan kompatibilitas.

Respons

200 success: 1 dan array otelde. Jika tidak ada tamu yang menginap, array-nya kosong; ini bukan error.

successinteger

1 berhasil, 0 gagal. Berupa angka, bukan boolean seperti di Online Booking.

otelde[]object[]

Record tamu. Lihat bagian Objek di atas untuk daftar field.

Respons error

401 Header ApiKey tidak ada, kosong, atau tidak terdaftar di HMS (mungkin telah dihapus). Body: {"success": 0}.
405 Permintaan menggunakan metode selain POST (misalnya GET dari bilah alamat browser).

Permintaan

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

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

Respons · 200 (tidak ada tamu yang menginap)

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

Respons · 401 (kunci tidak valid)

{
    "success": 0
}

Terakhir diperbarui: 21 September 2026Menemukan kesalahan? Beri tahu kami