Διαμένοντες επισκέπτες

Ο μοναδικός πόρος της ενσωμάτωσης hotspot. Επιστρέφει δωμάτιο, στοιχεία ταυτότητας και στοιχεία check-in/check-out για κάθε επισκέπτη που διαμένει αυτή τη στιγμή στο ξενοδοχείο (έχει κάνει check-in και όχι ακόμη check-out). Το λογισμικό hotspot ανακτά αυτή τη λίστα ανά τακτά διαστήματα και ανοίγει ή κλείνει ανάλογα τους λογαριασμούς Wi-Fi· τα βήματα περιγράφονται στον οδηγό Ροή επαλήθευσης επισκεπτών.

POST/public/json/customer/inhotelΛίστα διαμενόντων επισκεπτών

Αντικείμενο#

Πεδία

uniqueinteger
Αναγνωριστικό εγγραφής διαμονής, μοναδικό ανά επισκέπτη και κράτηση. Χρησιμοποιήστε το ως κλειδί χρήστη / συνεδρίας στην πλευρά του hotspot.
rezervasyon_idinteger
Αναγνωριστικό κράτησης. Οι επισκέπτες που μοιράζονται δωμάτιο έχουν την ίδια τιμή.
inHotelinteger
1 = ο επισκέπτης διαμένει στο ξενοδοχείο. Είναι πάντα 1, αφού το τελικό σημείο επιστρέφει μόνο διαμένοντες επισκέπτες.
firstNamestring
Όνομα. Συνήθως με κεφαλαία, όπως διαβάζεται από το έγγραφο ταυτότητας· τα πολλαπλά ονόματα χωρίζονται με κενό.
lastNamestring
Επώνυμο. Συνήθως με κεφαλαία.
identityNumberstring | null
Τουρκικός αριθμός εθνικής ταυτότητας ή αριθμός διαβατηρίου, όπως αναγράφεται στο έγγραφο. Μπορεί να είναι κενός για επισκέπτες που καταχωρίστηκαν χωρίς στοιχεία ταυτότητας.
birthDatestring | null
Ημερομηνία γέννησης, DD.MM.YYYY. Μπορεί να είναι κενή.
roomIDinteger
Το αναγνωριστικό HMS του δωματίου.
roomNamestring
Όνομα / αριθμός δωματίου, όπως τον βλέπει ο επισκέπτης στην πόρτα και στην κάρτα-κλειδί. Αυτόν ζητήστε ως «αριθμό δωματίου» στο portal.
checkininteger
Ώρα check-in του επισκέπτη ως χρονοσφραγίδα Unix (δευτερόλεπτα).
checkoutinteger
Προγραμματισμένη ημερομηνία αναχώρησης ως χρονοσφραγίδα Unix στην αρχή της ημέρας (00:00 UTC)· δεν περιέχει ώρα. Προσθέστε την ώρα check-out του ξενοδοχείου (συνήθως 12:00) για να βρείτε τη λήξη της συνεδρίας.
checkout2integer | null
Πραγματική ώρα αναχώρησης. null για τους διαμένοντες επισκέπτες· ένας επισκέπτης που κάνει check-out αφαιρείται έτσι κι αλλιώς από τη λίστα.
mikrotikSifrelemeinteger
Η ρύθμιση κρυπτογράφησης Mikrotik του κτιρίου του δωματίου στο HMS: 0 όνομα δωματίου (ο κωδικός Wi-Fi είναι ο αριθμός δωματίου), 1 χωρίς κωδικό. Εφαρμόστε την ίδια πολιτική στο δικό σας portal.
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

Επιστρέφει την πλήρη λίστα των διαμενόντων επισκεπτών. Δεν υπάρχουν παράμετροι φιλτραρίσματος ούτε σώμα αιτήματος. Ένας επισκέπτης εμφανίζεται στη λίστα όταν η κράτηση είναι ενεργή, έχει γίνει check-in και όχι ακόμη check-out, και ο επισκέπτης είναι σημειωμένος ως «εντός ξενοδοχείου». Κάθε επισκέπτης της ίδιας κράτησης είναι ξεχωριστή εγγραφή.

Η απόκριση δεν σελιδοποιείται· μεγάλα ξενοδοχεία μπορεί να επιστρέψουν αρκετές εκατοντάδες εγγραφές. Κρατήστε τη λίστα στην cache και ανανεώνετέ τη στο προτεινόμενο διάστημα.

Κεφαλίδες

ApiKeystringυποχρεωτικό
Προσαρμοσμένο κλειδί API που δημιουργείται στον πίνακα διαχείρισης του HMS. Δεσμεύεται σε ένα ξενοδοχείο· αυτό καθορίζει ποιοι επισκέπτες εμφανίζονται στη λίστα.
HotelCodeinteger
Το αναγνωριστικό HMS του ξενοδοχείου. Δεν χρησιμοποιείται για επικύρωση, αφού ο διακομιστής εντοπίζει το ξενοδοχείο από το κλειδί· συνιστάται για καταγραφή και συμβατότητα.

Απόκριση

200 success: 1 και ο πίνακας otelde. Αν δεν διαμένει κανείς, ο πίνακας είναι κενός· αυτό δεν αποτελεί σφάλμα.

successinteger
1 επιτυχία, 0 αποτυχία. Αριθμός, όχι boolean όπως στο 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"
Απόκριση · 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Βρήκατε κάποιο λάθος; Ενημερώστε μας