Amadeus HotSOS

Interfejs komunikuje z serwerem Amadeus HotSOS za pośrednictwem API REST.

Działanie

Interfejs synchronizuje tylko dane dotyczące pomieszczeń, a nie wydarzenia. Jeśli jest to konieczne, skontaktuj się z supportem Antcas.

Uwaga: Interfejs jest bardzo wolny przy wysyłaniu. Może upłynąć chwilę, zanim wartość pojawi się w monitorze.

Pytania są wykonywane indywidualnie przez serwer Antcas za pośrednictwem HTTPS na portal HotSOS. Adres URL API jest ustalony stałe i nie może być zmieniany. W ten sposób zapytane są pomieszczenia, które wcześniej zostały zdefiniowane w aplikacji HotSOS i w konfiguracji Antcas. Limit pytań wynosi domyślnie 30 pytań na minutę. Serwer Antcas ściśle przestrzega ustalonej polityki, aby zmniejszyć obciążenie drugiej strony i sieci. Oznacza to, że może upłynąć kilka minut, zanim zmiana zostanie odebrana przez serwer Antcas.

Podczas uruchamiania serwera wiadomości są zawsze pobierane jako pierwsze, a następnie przesyłane wszystkie statusy. W przypadku zmian po stronie HotSOS w trakcie tego procesu, skutkuje to tym, że status najpierw przychodzi do sterownika SPS, a następnie jest ponownie wysyłany.

W przypadku wystąpienia błędu połączenia zapytanie zostaje automatycznie powtórzone po osiągnięciu limitu czasu. Komunikat o błędzie pojawia się tylko raz w monitorze. Jeśli nie nastąpi połączenie w ciągu ustalonego limitu czasu połączenia, interfejs zostaje oznaczony jako offline.

Konfiguracja

Adres docelowy to adres serwera bez URI i prefiksu https://.

Uwaga: Przy użyciu serwera proxy należy upewnić się, że ścieżka URI nie zmienia się.

Monitor

Monitor może wyświetlać różne źródła. W poniższej tabeli opisano wszystkie możliwości.

Źródło	Opis
Klient	Wartość otrzymana od strony HotSOS.
Serwer	Wartość wysłana lub odczytana przez Antcas Control.
System	Ogólna wiadomość systemowa.

Zmienne

Nazwa	Typ danych	Opis
id	string	Ustawia numer pokoju zgodnie z interfejsem.
make_up	bool	Żądanie sprzątania pokoju.
service_status	string	Aktualny status usługi pokoju.
status	string	Status pokoju.
name	string	Otrzymana nazwa pokoju.
dnd	bool	Otrzymany Do Not Disturb.
occupied	bool	Pokój jest zajęty.

Uwaga: Można wysyłać tylko następujące wartości. Wszystkie inne wartości nie są wysyłane i są oznaczone na czerwono w monitorze.

status

Wartość	Opis
CLEAN	Pokój jest czysty.
DIRTY	Pokój jest brudny.
OUT_OF_ORDER	Pokój jest uszkodzony.
OUT_OF_SERVICE	Pokój jest nieczynny.
INSPECTED	Pokój został zbadany.
PICKUP	Pokój znajduje się w statusie odbioru.

service_status

Uwaga: Można wysyłać tylko wartości AWAITING_SERVICE i DO_NOT_DISTURB.

Wartość	Opis
AWAITING_SERVICE	Pokój czeka na sprzątanie.
DO_NOT_DISTURB	Gość nie chce być przeszkadzany.
VACANT_CLEANED	Pokój został wyczyszczony i jest wolny.
OCCUPIED_CLEANED	Pokój jest zajęty i wyczyszczony.
CLEANING_STARTED	Sprzątanie pokoju zostało rozpoczęte.
SERVICE_REFUSED	Gość odmówił usługi.
STOPPED	Sprzątanie zostało zatrzymane.
TO_BE_INSPECTED	Pokój wymaga inspekcji.
INSPECTED	Pokój został zbadany.
LATE_SERVICE	Gość chce późniejszą usługę.
RETURN_LATER	Gość poprosił o późniejsze powrót.