Actabl Alice

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

Λειτουργία

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

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

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

Σημείωση: Συνιστάται η μετάδοση κάθε τιμής μία φορά την ημέρα. Η διεπαφή μπορεί μόνο να στείλει και δεν μπορεί να διαβάσει τις τιμές.

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

Ρύθμιση

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

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

Παρατηρητής

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

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

Μεταβλητές

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