AMADEUS HOTSOS

介面通過 REST-API 與 Amadeus HotSOS 伺服器進行通訊。

功能區塊

介面僅同步房間數據，不會同步事件。如果需要此功能，請聯繫 Antcas 支援團隊。

注意： 介面在發送時非常緩慢。可能需要一段時間才能在監視器中顯示值。

Antcas 伺服器通過 HTTPS 對 HotSOS 入口網站進行單獨的輪詢。API URL 是固定設置的，無法更改。此時會查詢在 HotSOS 應用程序和 Antcas Config 中之前定義的房間。每分鐘的輪詢限制預設為 30 次查詢。Antcas 伺服器嚴格遵守設置的策略，以減少對方和網絡的負載。這意味着可能需要幾分鐘才能將 Antcas 伺服器上的更改傳輸過來。

啟動伺服器時，首先獲取消息，然後傳輸所有狀態消息。如果 HotSOS 方面在中途發生變化，則會導致狀態先到達 SPS，然後再次發送。

如果發生連接錯誤，則在超時到期後自動重複查詢。錯誤消息僅在監視器中顯示一次。如果在設置的連接超時內無法建立連接，則還會將介面標記為離線。

設定

目標地址是不帶 URI 和 https:// 前綴的伺服器地址。

注意： 使用代理伺服器時，請確保 URI 路徑未更改。

監視器

監視器可以顯示各種來源。以下表格說明了所有可能性。

來源	描述
客戶端	來自 HotSOS 對端的值。
伺服器	由 Antcas Control 發送或讀取的值。
系統	一般系統消息。

變數

名稱	資料類型	描述
id	string	根據介面設置房間號碼。
make_up	bool	請求清潔房間。
service_status	string	房間的當前服務狀態。
status	string	房間的狀態。
name	string	接收到的房間名稱。
dnd	bool	接收到的請勿打擾。
occupied	bool	房間已佔用。

注意： 僅可發送以下值。其他所有值都不會發送，並在監視器中標記為紅色。

狀態

值	描述
CLEAN	房間很乾淨。
DIRTY	房間很髒。
OUT_OF_ORDER	房間受損。
OUT_OF_SERVICE	房間已停用。
INSPECTED	房間已檢查。
PICKUP	房間處於取件狀態。

服務狀態

注意： 僅可發送 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	客人請求稍後返回。