Amadeus HotSOS

Interfața comunică cu un Server Amadeus HotSOS prin intermediul API-ului REST.

Funcționare

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.

Configurare

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.

Monitor

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.

Variabile

Nume Tip de date Descriere
id string Setează numărul camerei conform interfeței.
make_up bool Cerere de curățare a camerei.
service_status string Starea actuală de serviciu a camerei.
status string Starea camerei.
name string Numele camerei primit.
dnd bool Do Not Disturb primit.
occupied 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.

status

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.

service_status

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.