Αποκρίσεις σφαλμάτων

Το Hotspot API παράγει δύο είδη αποτελεσμάτων: αποτυχία ελέγχου ταυτότητας (HTTP 401) και επιτυχή απόκριση (HTTP 200). Μια κενή λίστα επισκεπτών δεν είναι σφάλμα. Παρακάτω θα βρείτε τις περιπτώσεις που μπορεί να συναντήσετε και τι κάνετε σε καθεμία.

Κωδικοί κατάστασης HTTP#

Κωδικός	Σώμα	Σημασία και τι κάνετε
`200`	`{"success": 1, "otelde": [...]}`	Επιτυχία. Επεξεργαστείτε τη λίστα.
`200`	`{"success": 1, "otelde": []}`	Επιτυχία· δεν διαμένει κανείς. Δείτε παρακάτω τη σημείωση για τις κενές λίστες.
`401`	`{"success": 0}`	Η κεφαλίδα `ApiKey` λείπει ή το κλειδί δεν αναγνωρίζεται. Μην επαναλαμβάνετε· ελέγξτε το κλειδί και ειδοποιήστε τον διαχειριστή.
`404`	Σελίδα σφάλματος	Λάθος διαδρομή. Βεβαιωθείτε ότι η διαδρομή είναι ακριβώς `/public/json/customer/inhotel`.
`405`	Σελίδα σφάλματος	Χρησιμοποιήθηκε μέθοδος διαφορετική από `POST` (π.χ. `GET` από πρόγραμμα περιήγησης).
`5xx` / λήξη χρόνου	—	Προσωρινό σφάλμα διακομιστή ή δικτύου. Επαναλάβετε με αυξανόμενες καθυστερήσεις (30 s, 1 min, 5 min) και στο μεταξύ συνεχίστε να χρησιμοποιείτε την τελευταία επιτυχή λίστα.

Κενή λίστα#

Το otelde: [] σημαίνει ότι δεν διαμένει κανένας επισκέπτης με check-in, κάτι φυσιολογικό για μικρά ξενοδοχεία εκτός σεζόν. Ωστόσο, μια λίστα που ήταν γεμάτη στο προηγούμενο ερώτημα και ξαφνικά είναι κενή συνήθως υποδεικνύει λειτουργικό λάθος στην πλευρά του ξενοδοχείου (λανθασμένο μαζικό check-out, αλλαγή κατάστασης κράτησης). Πριν κλείσετε όλους τους λογαριασμούς Wi-Fi, βεβαιωθείτε ότι η λίστα επέστρεψε κενή σε δύο διαδοχικά ερωτήματα.

Επαναλήψεις και χρονικά όρια#

Χρησιμοποιήστε χρονικό όριο αιτήματος 10 δευτερολέπτων· ακόμη και για μεγάλα ξενοδοχεία η λίστα επιστρέφει μέσα σε αυτό.
Επαναλάβετε σε 5xx και σφάλματα δικτύου· μην επαναλαμβάνετε σε 401, 404 ή 405, που είναι σφάλματα διαμόρφωσης.
Διατηρήστε την τελευταία επιτυχή λίστα όσο ένα ερώτημα αποτυγχάνει. Κλείνετε λογαριασμούς μόνο για επισκέπτες που αφαιρέθηκαν από τη λίστα σε μια επιτυχή απόκριση.
Μετράτε τις διαδοχικές αποτυχίες και ειδοποιήστε τον διαχειριστή όταν ξεπεραστεί ένα όριο (π.χ. 15 λεπτά).

Συνήθεις περιπτώσεις#

Περίπτωση	Πιθανή αιτία	Τι κάνετε
Ο επισκέπτης δεν υπάρχει στη λίστα	Η ρεσεψιόν δεν έχει κάνει check-in στον επισκέπτη, η κράτηση ακυρώθηκε, ο επισκέπτης δεν είναι σημειωμένος ως «εντός ξενοδοχείου» ή έχει κάνει check-out.	Εμφανίστε στο portal «ο αριθμός δωματίου και το επώνυμο δεν ταιριάζουν» και παραπέμψτε τον επισκέπτη στη ρεσεψιόν. Δεν χρειάζεται νέα ανάκτηση· ο επισκέπτης εμφανίζεται στον επόμενο συγχρονισμό.
Πολλές εγγραφές για το ίδιο δωμάτιο	Στο δωμάτιο διαμένουν περισσότεροι από ένας επισκέπτες· καθένας είναι ξεχωριστή εγγραφή.	Φυσιολογικό. Ανοίξτε λογαριασμούς ανά επισκέπτη (`unique`).
Κενό `identityNumber`	Ο επισκέπτης καταχωρίστηκε χωρίς στοιχεία ταυτότητας.	Για την αντιστοίχιση χρησιμοποιήστε εναλλακτικά επώνυμο + ημερομηνία γέννησης· αφήστε το πεδίο κενό στην εγγραφή του νόμου 5651 και συνδέστε την με το `unique`.
Το `roomName` δεν ταιριάζει	Ο επισκέπτης πληκτρολόγησε «0104» ή «Δωμάτιο 104» αντί για «104»· η τιμή είναι συμβολοσειρά.	Κανονικοποιήστε και τις δύο πλευρές πριν από τη σύγκριση· μην τη μετατρέπετε σε αριθμό.
Το `checkout` είναι στο παρελθόν αλλά ο επισκέπτης είναι ακόμη στη λίστα	Ο επισκέπτης παρέτεινε τη διαμονή ή αναχωρεί αργότερα και η ρεσεψιόν δεν το έχει καταχωρίσει ακόμη.	Διατηρήστε την πρόσβαση ανοιχτή όσο ο επισκέπτης βρίσκεται στη λίστα· ενημερώστε τη λήξη της συνεδρίας όταν αλλάξει το `checkout`.

Τελευταία ενημέρωση: 21 Σεπτεμβρίου 2026Βρήκατε κάποιο λάθος; Ενημερώστε μας