Interfața comunică cu un Server Amadeus HotSOS prin intermediul API-ului REST.
Interfața sincronizează doar datele camerei și nu evenimentele. Dacă este necesar, contactați suportul Antcas.
Atenție: Interfața este foarte lentă la trimitere. Poate dura un moment până când valoarea apare în monitor.
Sunt efectuate poll-uri individuale de către serverul Antcas prin HTTPS pe portalul HotSOS. URL-ul API este fix stabilit și nu poate fi modificat. Astfel, sunt interogate camerele care au fost definite anterior în aplicația HotSOS și în Antcas Config. Limita de poll are implicit 30 interogări pe minut. Serverul Antcas respectă strict politica stabilită pentru a reduce încărcarea părții opuse și a rețelei. Aceasta înseamnă că poate dura câteva minute până când o modificare ajunge la serverul Antcas.
La pornirea serverului, mesajele sunt întotdeauna preluate mai întâi, iar apoi toate stările de serviciu sunt transferate. Dacă apare o modificare între timp din partea HotSOS, aceasta are ca efect ca starea să ajungă mai întâi la SPS și apoi să fie trimisă din nou.
Dacă apare o eroare de conexiune, interogarea este repetată automat după ce se atinge timeout-ul. Mesajul de eroare apare doar o dată în monitor. Dacă nu se realizează o conexiune în cadrul timeout-ului de conexiune stabilit, atunci interfața este declarată ca fiind offline.
Adresa țintă este adresa serverului fără URI și prefixul https://.
Atenție: Când se utilizează un server proxy, trebuie avut grijă ca calea URI să nu se modifice.
Monitorul poate afișa diverse surse. În tabelul următor sunt explicate toate posibilitățile.
| Sursă | Descriere |
|---|---|
| Client | Valoarea primită de la partea HotSOS. |
| Server | Valoarea trimisă sau citită de Antcas Control. |
| Sistem | Mesaj general al sistemului. |
| Nume | Tip de date | Descriere |
|---|---|---|
| string | Setează numărul camerei conform interfeței. | |
| bool | Cerere de curățare a camerei. | |
| string | Starea actuală de serviciu a camerei. | |
| string | Starea camerei. | |
| string | Numele camerei primit. | |
| bool | Do Not Disturb primit. | |
| bool | Camera este ocupată. |
Atenție: Pot fi trimise doar următoarele valori. Toate celelalte valori nu sunt trimise și sunt marcate în roșu în monitor.
| Valoare | Descriere |
|---|---|
| CLEAN | Camera este curată. |
| DIRTY | Camera este murdară. |
| OUT_OF_ORDER | Camera este avariată. |
| OUT_OF_SERVICE | Camera este în afara serviciului. |
| INSPECTED | Camera a fost inspectată. |
| PICKUP | Camera se află în starea de ridicare. |
Atenție: Pot fi trimise doar valorile AWAITING_SERVICE și DO_NOT_DISTURB.
| Valoare | Descriere |
|---|---|
| AWAITING_SERVICE | Camera așteaptă curățarea. |
| DO_NOT_DISTURB | Oaspetele nu dorește să fie deranjat. |
| VACANT_CLEANED | Camera a fost curățată și este liberă. |
| OCCUPIED_CLEANED | Camera este curățată și ocupată. |
| CLEANING_STARTED | Curățarea camerei a început. |
| SERVICE_REFUSED | Oaspetele a refuzat serviciul. |
| STOPPED | Curățarea a fost oprită. |
| TO_BE_INSPECTED | Camera are nevoie de o inspecție. |
| INSPECTED | Camera a fost inspectată. |
| LATE_SERVICE | Oaspetele dorește un serviciu târziu. |
| RETURN_LATER | Oaspetele a cerut o întoarcere mai târziu. |