Oaspeți cazați

Singura resursă a integrării hotspot. Returnează datele despre cameră, identitate și check-in/check-out pentru fiecare oaspete cazat în prezent (cu check-in făcut și fără check-out). Software-ul hotspot preia această listă la intervale regulate și deschide sau închide conturile Wi-Fi în consecință; pașii sunt descriși în ghidul Fluxul de verificare a oaspeților.

POST/public/json/customer/inhotelLista oaspeților cazați

Obiect#

Câmpuri

uniqueinteger
ID-ul înregistrării de sejur, unic pentru fiecare oaspete și rezervare. Folosiți-l drept cheie de utilizator / sesiune în sistemul hotspot.
rezervasyon_idinteger
ID-ul rezervării. Oaspeții care împart o cameră au aceeași valoare.
inHotelinteger
1 = oaspetele este cazat. Întotdeauna 1, deoarece endpointul returnează doar oaspeții cazați.
firstNamestring
Prenumele. De obicei cu majuscule, așa cum a fost citit din actul de identitate; mai multe prenume sunt separate prin spațiu.
lastNamestring
Numele de familie. De obicei cu majuscule.
identityNumberstring | null
Numărul național de identificare turc sau numărul pașaportului, așa cum apare în document. Poate fi gol pentru oaspeții înregistrați fără datele actului de identitate.
birthDatestring | null
Data nașterii, DD.MM.YYYY. Poate fi goală.
roomIDinteger
ID-ul HMS al camerei.
roomNamestring
Denumirea / numărul camerei, așa cum îl vede oaspetele pe ușă și pe cardul-cheie. Pe portal, cereți această valoare ca „număr al camerei”.
checkininteger
Ora de check-in a oaspetelui, ca marcaj de timp Unix (secunde).
checkoutinteger
Data planificată de check-out, ca marcaj de timp Unix la începutul zilei (00:00 UTC); nu conține ora. Adăugați ora de check-out a hotelului (de obicei 12:00) pentru a obține sfârșitul sesiunii.
checkout2integer | null
Ora efectivă de check-out. null pentru oaspeții cazați; oricum, un oaspete care face check-out dispare din listă.
mikrotikSifrelemeinteger
Setarea de criptare Mikrotik a clădirii în care se află camera, în HMS: 0 numele camerei (parola Wi-Fi este numărul camerei), 1 fără parolă. Aplicați aceeași politică pe propriul portal.
01
Obiect exemplu
{
    "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 oaspeților cazați#

POST/public/json/customer/inhotel

Autentificare: Antetul ApiKey

Returnează lista completă a oaspeților cazați. Nu există parametri de filtrare și nici corp al cererii. Un oaspete apare în listă când rezervarea este activă, s-a făcut check-in, dar încă nu și check-out, iar oaspetele este marcat „cazat”. Fiecare oaspete al aceleiași rezervări este o înregistrare separată.

Răspunsul nu este paginat; hotelurile mari pot returna câteva sute de înregistrări. Păstrați lista în cache și reîmprospătați-o la intervalul recomandat.

Anteturi

ApiKeystringobligatoriu
Cheie API personalizată, generată în panoul de administrare HMS. Este legată de un singur hotel, iar acesta determină ai cui oaspeți sunt listați.
HotelCodeinteger
ID-ul HMS al hotelului. Nu se folosește la validare, deoarece serverul determină hotelul din cheie; recomandat pentru jurnalizare și compatibilitate.

Răspuns

200 success: 1 și tabloul otelde. Dacă nu este cazat nimeni, tabloul este gol; aceasta nu este o eroare.

successinteger
1 succes, 0 eșec. Un număr, nu un boolean ca în Online Booking.
otelde[]object[]
Înregistrările oaspeților. Pentru câmpuri, consultați secțiunea Obiect de mai sus.

Răspunsuri de eroare

  • 401 Antetul ApiKey lipsește, este gol sau nu este definit în HMS (este posibil să fi fost șters). Corp: {"success": 0}.
  • 405 Cererea a folosit altă metodă decât POST (de exemplu GET din bara de adrese a browserului).
Cerere
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
  -H "ApiKey: $HMS_API_KEY" \
  -H "HotelCode: 1000"
Răspuns · 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
        }
    ]
}
Răspuns · 200 (niciun oaspete cazat)
{
    "success": 1,
    "otelde": []
}
Răspuns · 401 (cheie nevalidă)
{
    "success": 0
}
Ultima actualizare: 21 septembrie 2026Ați găsit o greșeală? Anunțați-ne