Amadeus HotSOS

该接口通过REST-API与Amadeus HotSOS服务器通信。

功能方式

该接口仅同步房间数据，不同步事件。如果需要此功能，请联系Antcas支持团队。

注意： 该接口发送速度很慢。可能需要一段时间才能在监视器中看到值。

通过HTTPS，Antcas服务器对HotSOS门户执行单独的轮询。API URL固定设置且无法更改。此过程中会查询在HotSOS应用程序和Antcas配置中之前定义的房间。每分钟默认轮询限制为30次查询。Antcas服务器严格遵守设置的策略，以减少对方和网络的负载。这意味着可能需要几分钟才能将更改传递到Antcas服务器。

启动服务器时，首先获取消息，然后传输所有状态消息。如果HotSOS方面在中途发生变化，则会导致状态先到达PLC，然后再次发送。

如果出现连接错误，则在达到超时后自动重复查询。此时仅在监视器中显示一次错误消息。如果在设置的连接超时内无法建立连接，则还会将该接口标记为离线状态。

配置

目标地址是服务器地址，不带URI和https://前缀。

注意： 使用代理服务器时，请确保URI路径未更改。

监视器

监视器可以显示各种来源。以下表格说明了所有可能性。

来源	描述
客户端	来自HotSOS对端的值。
服务器	由Antcas Control发送或读取的值。
系统	一般系统消息。

变量

名称	数据类型	描述
id	string	根据接口设置房间号码。
make_up	bool	请求清洁房间。
service_status	string	房间的当前服务状态。
status	string	房间的状态。
name	string	接收到的房间名称。
dnd	bool	接收到的请勿打扰信号。
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	客人请求稍后返回。