A kapcsolati felület kommunikál egy Amadeus HotSOS szerverrel REST-API-n keresztül.
A kapcsolati felület csak a helyiségek adatainak szinkronizálását végzi, nem pedig az eseményekét. Ha ez szükséges lenne, forduljon a Antcas támogatásához.
Figyelmeztetés: A kapcsolati felület nagyon lassú az adatok küldésekor. Néha egy kicsit várni kell, amíg az érték megjelenik a monitorban.
A Antcas szerver HTTPS-n keresztül végzi a HotSOS portálra történő lekérdezéseket. Az API-URL rögzített és nem módosítható. Ekkor azok a helyiségek kérdezhetők le, amelyek korábban a HotSOS alkalmazásban és az Antcas Config-ban lettek meghatározva. Az alapértelmezett poll-limit 30 lekérdezés percenként. A Antcas szerver szigorúan betartja a beállított irányelvet, hogy csökkentse a másik oldal és a hálózat terhelését. Ez azt jelenti, hogy néhány percbe bele lehet kerülni, amíg egy változás eljut a Antcas szerverhez.
Amikor a szervert indítják, először a üzenetek letöltődnek, majd az összes állapotüzenet át lesz küldve. Ha közben változás történik a HotSOS oldalán, akkor az állapot előbb érkezik meg a SPS-be, majd újra elküldik.
Ha kapcsolati hiba lép fel, a lekérdezés automatikusan ismétlődik a timeout elérését követően. A hibajelzést csak egyszer jeleníti meg a monitor. Ha nem jön létre kapcsolat a beállított kapcsolati időtúllépésen belül, akkor a kapcsolati felület offline státuszba kerül.
A célcím a szerver címe URI nélkül és https://-prefix nélkül.
Figyelmeztetés: Ha proxy-szervert használ, akkor figyeljen arra, hogy az URI-útvonal ne változzon meg.
A monitor különböző forrásokat jeleníthet meg. Az alábbi táblázatban mindent magyarázunk.
| Forrás | Leírás |
|---|---|
| Client | A HotSOS ellenőrzött érték. |
| Server | Az Antcas Control által küldött vagy olvasott érték. |
| System | Általános rendszerüzenet. |
| Név | Adattípus | Leírás |
|---|---|---|
| string | A helyiség számának beállítása a kapcsolati felület szerint. | |
| bool | Szoba takarításának kérése. | |
| string | A helyiség aktuális szolgáltatási állapota. | |
| string | A helyiség állapota. | |
| string | A kapott helyiség neve. | |
| bool | Do Not Disturb fogadása. | |
| bool | A helyiség foglalt. |
Figyelmeztetés: Csak az alábbi értékeket lehet küldeni. A többi érték nem kerül küldésre és pirosan lesz megjelölve a monitorban.
| Érték | Leírás |
|---|---|
| CLEAN | A helyiség tisztán van. |
| DIRTY | A helyiség piszkos. |
| OUT_OF_ORDER | A helyiség megrongálódott. |
| OUT_OF_SERVICE | A helyiség nem működik. |
| INSPECTED | A helyiséget ellenőrizték. |
| PICKUP | A helyiség a felvétel állapotban van. |
Figyelmeztetés: Csak az AWAITING_SERVICE és DO_NOT_DISTURB értékeket lehet küldeni.
| Érték | Leírás |
|---|---|
| AWAITING_SERVICE | A helyiség vár takarításra. |
| DO_NOT_DISTURB | A vendég nem akar zűrzavart. |
| VACANT_CLEANED | A helyiség megtisztítva és szabad. |
| OCCUPIED_CLEANED | A helyiség megtisztítva és foglalt. |
| CLEANING_STARTED | A helyiség takarítása elkezdődött. |
| SERVICE_REFUSED | A vendég elutasította a szolgáltatást. |
| STOPPED | A takarítás leállt. |
| TO_BE_INSPECTED | A helyiség ellenőrzésre szorul. |
| INSPECTED | A helyiséget ellenőrizték. |
| LATE_SERVICE | A vendég későbbi szolgáltatást kért. |
| RETURN_LATER | A vendég később való visszatérést kért. |