Amadeus HotSOS

Η διεπαφή επικοινωνεί με έναν Amadeus HotSOS Server μέσω REST-API.

Λειτουργία

Η διεπαφή συγχρονίζει μόνο τα δεδομένα των χώρων και όχι τα γεγονότα. Αν αυτό είναι απαραίτητο, επικοινωνήστε με την υποστήριξη της Antcas.

Σημείωση: Η διεπαφή είναι πολύ αργή κατά το αποστολή. Μπορεί να χρειαστεί λίγο χρόνο μέχρι να εμφανιστεί η τιμή στον παρατηρητή.

Γίνονται ατομικές ερωτήσεις από τον διακομιστή Antcas μέσω HTTPS στο HotSOS portal. Το API-URL είναι σταθερά ορισμένο και δεν μπορεί να αλλάξει. Ερωτώνται οι χώροι που έχουν οριστεί προηγουμένως στην εφαρμογή HotSOS και στο Antcas Config. Η όριο ερωτήσεων είναι κατά προεπιλογή 30 ερωτήσεις ανά λεπτό. Ο διακομιστής Antcas τείνει να ακολουθεί αυστηρά την ορισμένη πολιτική, για να μειώσει το φορτίο της αντίπαλης πλευράς και του δικτύου. Αυτό σημαίνει ότι μπορεί να χρειαστούν μερικά λεπτά μέχρι μια αλλαγή να φτάσει στον διακομιστή Antcas.

Κατά την εκκίνηση του διακομιστή, πάντα πρώτα λαμβάνονται τα μηνύματα και μετά μεταφέρονται όλες οι καταστάσεις. Σε περίπτωση μεσαίας αλλαγής από τη πλευρά του HotSOS, αυτό έχει ως αποτέλεσμα η κατάσταση να φτάνει πρώτα στην SPS και μετά να αποστέλλεται ξανά.

Αν συμβεί σφάλμα σύνδεσης, η ερώτηση επαναλαμβάνεται αυτόματα μετά την ολοκλήρωση του timeout. Το μήνυμα σφάλματος εμφανίζεται μόνο μία φορά στον παρατηρητή. Αν δεν γίνει σύνδεση εντός του ορισμένου χρονικού όρου σύνδεσης, τότε η διεπαφή δηλώνεται ως εκτός λειτουργίας.

Ρύθμιση

Η προοριστική διεύθυνση είναι η διεύθυνση του διακομιστή χωρίς URI και https://-πρόθεμα.

Σημείωση: Όταν χρησιμοποιείται ένας διακομιστής proxy, πρέπει να ληφθεί υπόψη ότι ο URI δεν αλλάζει.

Παρατηρητής

Ο παρατηρητής μπορεί να εμφανίζει διάφορες πηγές. Στο παρακάτω πίνακα εξηγούνται όλες οι δυνατότητες.

Πηγή	Περιγραφή
Client	Τιμή που προέρχεται από την αντίπαλη πλευρά HotSOS.
Server	Τιμή που αποστέλλεται ή διαβάζεται από το Antcas Control.
System	Γενικό μήνυμα συστήματος.

Μεταβλητές

Όνομα	Τύπος Δεδομένων	Περιγραφή
id	string	Ορίζει τον αριθμό του χώρου σύμφωνα με τη διεπαφή.
make_up	bool	Αίτηση καθαρισμού δωματίου.
service_status	string	Τρέχουσα κατάσταση υπηρεσίας του χώρου.
status	string	Κατάσταση του χώρου.
name	string	Ληφθείσα ονομασία χώρου.
dnd	bool	Λήψη Do Not Disturb.
occupied	bool	Ο χώρος είναι κατειλημμένος.

Σημείωση: Μπορούν να αποσταλούν μόνο οι ακόλουθες τιμές. Όλες οι άλλες τιμές δεν αποστέλλονται και σημειώνονται με κόκκινο χρώμα στον παρατηρητή.

status

Τιμή	Περιγραφή
CLEAN	Ο χώρος είναι καθαρός.
DIRTY	Ο χώρος είναι βρόμικος.
OUT_OF_ORDER	Ο χώρος είναι κατεστραμμένος.
OUT_OF_SERVICE	Ο χώρος είναι εκτός λειτουργίας.
INSPECTED	Ο χώρος έχει ελεγχθεί.
PICKUP	Ο χώρος βρίσκεται στην κατάσταση συλλογής.

service_status

Σημείωση: Μπορούν να αποσταλούν μόνο οι τιμές AWAITING_SERVICE και DO_NOT_DISTURB.

Τιμή	Περιγραφή
AWAITING_SERVICE	Ο χώρος περιμένει καθαρισμό.
DO_NOT_DISTURB	Ο πελάτης δεν θέλει να διαταραχθεί.
VACANT_CLEANED	Ο χώρος έχει καθαριστεί και είναι ελεύθερος.
OCCUPIED_CLEANED	Ο χώρος είναι καθαρός και κατειλημμένος.
CLEANING_STARTED	Έχει ξεκινήσει ο καθαρισμός του χώρου.
SERVICE_REFUSED	Ο πελάτης έχει αρνηθεί την υπηρεσία.
STOPPED	Έχει σταματήσει ο καθαρισμός.
TO_BE_INSPECTED	Ο χώρος χρειάζεται έλεγχο.
INSPECTED	Ο χώρος έχει ελεγχθεί.
LATE_SERVICE	Ο πελάτης θέλει υπηρεσία αργότερα.
RETURN_LATER	Ο πελάτης έχει ζητήσει να επιστρέψει αργότερα.