Amadeus HotSOS

Rozhraní komunikuje s serverem Amadeus HotSOS přes REST-API.

Funkční princip

Rozhraní synchronizuje pouze data místností a neudálosti. Pokud je to nutné, obraťte se na podporu Antcas.

Poznámka: Rozhraní je velmi pomalé při odesílání. Může chvíli trvat, než se hodnota zobrazí v monitoru.

Antcas Server provádí jednotlivé dotazy na HotSOS portál přes HTTPS. URL API je pevně stanovena a nelze ji změnit. Dotazují se místnosti, které byly dříve definovány v aplikaci HotSOS a v Antcas Config. Standardní limit pollů činí 30 dotazů za minutu. Antcas Server přísně dodržuje nastavenou politiku, aby se snížilo zatížení druhé strany a sítě. To znamená, že může trvat několik minut, než se změna na serveru Antcas dostane.

Při spuštění serveru se nejprve získá zprávy a poté se přenášejí všechny stavové zprávy. Pokud dojde k mezitímné změně ze strany HotSOS, má to za následek, že status přijde nejprve v SPS a poté se znovu odešle.

Pokud dojde k chybě spojení, dotaz se po uplynutí timeoutu automaticky opakuje. Chyba se zobrazí pouze jednou v monitoru. Pokud nedojde ke spojení během nastaveného časového limitu spojení, je také rozhraní označeno jako offline.

Konfigurace

Cílová adresa je adresa serveru bez URI a https://-prefixu.

Poznámka: Při použití proxy serveru je třeba dbát na to, aby se URI cesta nezměnila.

Monitor

Monitor může zobrazovat různé zdroje. V následující tabulce jsou popsány všechny možnosti.

Zdroj	Popis
Klient	Hodnota přijatá od HotSOS protistrany.
Server	Hodnota odebraná nebo odebraná Antcas Control.
Systém	Obecná systémová zpráva.

Proměnné

Jméno	Datový typ	Popis
id	string	Nastaví číslo místnosti podle rozhraní.
make_up	bool	Žádost o úklid místnosti.
service_status	string	Aktuální servisní stav místnosti.
status	string	Stav místnosti.
name	string	Přijaté jméno místnosti.
dnd	bool	Přijatý Do Not Disturb.
occupied	bool	Místnost je obsazena.

Poznámka: Mohou být odeslány pouze následující hodnoty. Všechny ostatní hodnoty nebudou odeslány a budou označeny červeně v monitoru.

status

Hodnota	Popis
CLEAN	Místnost je čistá.
DIRTY	Místnost je špinavá.
OUT_OF_ORDER	Místnost je poškozená.
OUT_OF_SERVICE	Místnost je mimo provoz.
INSPECTED	Místnost byla prohlédnuta.
PICKUP	Místnost je ve stavu odvozování.

service_status

Poznámka: Mohou být odeslány pouze hodnoty AWAITING_SERVICE a DO_NOT_DISTURB.

Hodnota	Popis
AWAITING_SERVICE	Místnost čeká na úklid.
DO_NOT_DISTURB	Host nechce být rušen.
VACANT_CLEANED	Místnost byla vyčištěna a je volná.
OCCUPIED_CLEANED	Místnost je vyčištěna a obsazena.
CLEANING_STARTED	Úklid místnosti byl zahájen.
SERVICE_REFUSED	Host odmítl službu.
STOPPED	Úklid byl zastaven.
TO_BE_INSPECTED	Místnost potřebuje prohlídku.
INSPECTED	Místnost byla prohlédnuta.
LATE_SERVICE	Host si přál pozdější službu.
RETURN_LATER	Host požádal o pozdější návrat.