Amadeus HotSOS

Sučelje komunicira s Amadeus HotSOS Serverom putem REST-API.

Način rada

Sučelje sinkronizira samo podatke o prostorijama, a ne događaje. Ako je to potrebno, obratite se podršci Antcas-a.

Napomena: Sučelje je vrlo sporo pri slanju. Može potrajati trenutak prije nego što se vrijednost pojavi u monitoru.

Antcas Server vrši pojedinačne pollove na HotSOS portal putem HTTPS-a. URL API-a je fiksno određen i ne može se mijenjati. Time se upitavaju prostorije koje su ranije definirane u HotSOS aplikaciji i Antcas Config-u. Standardna ograničenja za pollove iznosi 30 upita po minuti. Antcas Server strogo se pridržava postavljene politike kako bi se smanjila opterećenja na suprotnoj strani i mreži. To znači da može potrajati nekoliko minuta prije nego što promjena stigne do Antcas Servera.

Pri pokretanju servera uvijek se prvo preuzimaju poruke, a zatim se prenose svi statusni poruci. Ako se dogodi promjena na strani HotSOS-a između ovih događaja, to ima za posljedicu da status prvi stigne do SPS-a i zatim ponovno bude poslan.

Ako dođe do pogreške u vezi, upit će se automatski ponoviti nakon isteka vremena čekanja. Poruka o pogrešci će se pojaviti samo jednom u monitoru. Ako se ne uspostavi veza unutar postavljenog vremena čekanja za vezu, sučelje će biti označeno kao nedostupno.

Konfiguracija

Ciljna adresa je adresa servera bez URI-a i https:// prefiksa.

Napomena: Kada se koristi proxy-server, morate paziti da se URI put ne mijenja.

Monitor

Monitor može prikazivati različite izvore. U sljedećoj tablici objasnjeni su svi mogućnosti.

Izvor	Opis
Klijent	Vrijednost koja dolazi od HotSOS strane.
Server	Vrijednost koju je Antcas Control poslao ili pročitao.
Sustav	Opća poruka sustava.

Varijable

Ime	Tip podataka	Opis
id	string	Postavlja broj prostorije prema sučelju.
make_up	bool	Zatraži čišćenje sobe.
service_status	string	Trenutni status usluge prostorije.
status	string	Status prostorije.
name	string	Primljeno ime prostorije.
dnd	bool	Primljeno Do Not Disturb.
occupied	bool	Prostorija je zauzeta.

Napomena: Može se slati samo sljedeće vrijednosti. Sve ostale vrijednosti neće biti poslane i bit će označene crvenom bojom u monitoru.

status

Vrijednost	Opis
CLEAN	Prostorija je čista.
DIRTY	Prostorija je prljava.
OUT_OF_ORDER	Prostorija je oštećena.
OUT_OF_SERVICE	Prostorija je van službe.
INSPECTED	Prostorija je inspekcirana.
PICKUP	Prostorija se nalazi u statusu preuzimanja.

service_status

Napomena: Može se slati samo vrijednosti AWAITING_SERVICE i DO_NOT_DISTURB.

Vrijednost	Opis
AWAITING_SERVICE	Prostorija čeka na čišćenje.
DO_NOT_DISTURB	Gost ne želi biti smetanje.
VACANT_CLEANED	Prostorija je očistena i slobodna.
OCCUPIED_CLEANED	Prostorija je očistena i zauzeta.
CLEANING_STARTED	Počelo je čišćenje prostorije.
SERVICE_REFUSED	Gost je odbio uslugu.
STOPPED	Čišćenje je zaustavljeno.
TO_BE_INSPECTED	Prostorija treba inspekciju.
INSPECTED	Prostorija je inspekcirana.
LATE_SERVICE	Gost želi kasniju uslugu.
RETURN_LATER	Gost je zatražio kasnije povratak.