Amadeus HotSOS

Інтерфейс спілкується з сервером Amadeus HotSOS через REST-API.

Принцип дії

Інтерфейс синхронізує лише дані про кімнати, а не події. Якщо це необхідно, звертайтеся до підтримки Antcas.

Примітка: Інтерфейс дуже повільний при відправці. Можливо, знадобиться деякий час, щоб значення з'явилося в моніторі.

Антас-сервер здійснює окремі запити до порталу HotSOS через HTTPS. URL API зафіксовано і не може бути змінено. При цьому запитуються кімнати, які раніше були визначені в додатку HotSOS та в Antcas Config. Стандартне обмеження на кількість запитів становить 30 запитів за хвилину. Антас-сервер суворо дотримується встановленого правила, щоб зменшити навантаження на іншу сторону та мережу. Це означає, що може знадобитися кілька хвилин, перш ніж зміни будуть отримані на сервері Antcas.

При запуску сервера спочатку завжди отримуються повідомлення, а потім передаються всі статусні повідомлення. Якщо під час цього HotSOS змінює стан, то це призводить до того, що стан спочатку надходить до ПЛК, а потім відправляється повторно.

Якщо виникає помилка з'єднання, запит автоматично повторюється після досягнення тайм-ауту. Повідомлення про помилку з'являється в моніторі лише один раз. Якщо з'єднання не встановлюється протягом встановленого часу очікування з'єднання, то інтерфейс також оголошується офлайн.

Конфігурація

Цільова адреса - це адреса сервера без URI та префікса https://.

Примітка: При використанні проксі-сервера слід враховувати, що шлях URI не змінюється.

Монітор

Монітор може відображати різні джерела. У наступній таблиці розглядаються всі можливості.

Джерело	Опис
Клієнт	Значення, отримане від HotSOS.
Сервер	Значення, відправлене або прочитане Antcas Control.
Система	Загальне системне повідомлення.

Змінні

Назва	Тип даних	Опис
id	string	Встановлює номер кімнати відповідно до інтерфейсу.
make_up	bool	Запит на прибирання кімнати.
service_status	string	Поточний сервісний статус кімнати.
status	string	Статус кімнати.
name	string	Отримане ім'я кімнати.
dnd	bool	Отримано Do Not Disturb.
occupied	bool	Кімната зайнята.

Примітка: Можна відправляти лише наступні значення. Інші значення не відправляються і в моніторі позначені червоним кольором.

status

Значення	Опис
CLEAN	Кімната чиста.
DIRTY	Кімната брудна.
OUT_OF_ORDER	Кімната пошкоджена.
OUT_OF_SERVICE	Кімната виведена з експлуатації.
INSPECTED	Кімнату перевірено.
PICKUP	Кімната знаходиться в статусі очікування зняття.

service_status

Примітка: Можна відправляти лише значення AWAITING_SERVICE та DO_NOT_DISTURB.

Значення	Опис
AWAITING_SERVICE	Кімната чекає на прибирання.
DO_NOT_DISTURB	Гість не бажає бути потурбованим.
VACANT_CLEANED	Кімната прибрана і вільна.
OCCUPIED_CLEANED	Кімната прибрана і зайнята.
CLEANING_STARTED	Почато прибирання кімнати.
SERVICE_REFUSED	Гість відмовився від послуги.
STOPPED	Прибирання зупинено.
TO_BE_INSPECTED	Кімнату потрібно перевірити.
INSPECTED	Кімнату перевірено.
LATE_SERVICE	Гість бажає пізню послугу.
RETURN_LATER	Гість попросив повернутися пізніше.