Amadeus HotSOS

Giao diện giao tiếp với một Máy chủ Amadeus HotSOS qua REST-API.

Cách Hoạt Động

Giao diện chỉ đồng bộ hóa dữ liệu phòng và không đồng bộ hóa sự kiện. Nếu cần thiết, vui lòng liên hệ với bộ phận hỗ trợ của Antcas.

Lưu ý: Giao diện rất chậm khi gửi. Có thể mất một lúc trước khi giá trị xuất hiện trong trình theo dõi.

Các yêu cầu đơn lẻ được thực hiện từ máy chủ Antcas qua HTTPS đến cổng HotSOS. URL API được cố định và không thể thay đổi. Các phòng được xác định trước đó trong ứng dụng HotSOS và trong Antcas Config sẽ được truy vấn. Giới hạn yêu cầu mặc định là 30 yêu cầu mỗi phút. Máy chủ Antcas tuân theo chính sách đã thiết lập để giảm tải cho phía đối diện và mạng lưới. Điều này có nghĩa là có thể mất vài phút trước khi thay đổi được gửi đến máy chủ Antcas.

Khi khởi động máy chủ, thông báo sẽ được lấy trước tiên và sau đó tất cả các thông báo trạng thái được truyền. Nếu có sự thay đổi giữa thời gian của HotSOS, điều này dẫn đến việc trạng thái đầu tiên đến SPS và sau đó được gửi lại.

Nếu xảy ra lỗi kết nối, yêu cầu sẽ tự động được lặp lại khi đạt đến thời gian chờ. Thông báo lỗi chỉ xuất hiện một lần trong trình theo dõi. Nếu không có kết nối trong thời gian chờ kết nối đã thiết lập, giao diện cũng sẽ được đánh dấu là offline.

Cấu Hình

Địa chỉ đích là địa chỉ máy chủ mà không có URI và tiền tố https://.

Lưu ý: Khi sử dụng máy chủ proxy, cần đảm bảo rằng đường dẫn URI không thay đổi.

Trình Theo Dõi

Trình theo dõi có thể hiển thị nhiều nguồn khác nhau. Trong bảng sau, tất cả các tùy chọn sẽ được giải thích.

Nguồn	Mô tả
Khách	Giá trị đến từ phía đối diện HotSOS.
Máy chủ	Giá trị được gửi hoặc đọc bởi Antcas Control.
Hệ thống	Thông báo hệ thống chung.

Biến

Tên	Kiểu dữ liệu	Mô tả
id	string	Đặt số phòng theo giao diện.
make_up	bool	Yêu cầu dọn phòng.
service_status	string	Trạng thái dịch vụ hiện tại của phòng.
status	string	Trạng thái của phòng.
name	string	Tên phòng nhận được.
dnd	bool	Nhận Do Not Disturb.
occupied	bool	Phòng đang được sử dụng.

Lưu ý: Chỉ có thể gửi các giá trị sau. Các giá trị khác sẽ không được gửi và được đánh dấu màu đỏ trong trình theo dõi.

status

Giá Trị	Mô tả
CLEAN	Phòng đã được dọn sạch.
DIRTY	Phòng đang bẩn.
OUT_OF_ORDER	Phòng bị hỏng.
OUT_OF_SERVICE	Phòng đã ngừng hoạt động.
INSPECTED	Phòng đã được kiểm tra.
PICKUP	Phòng đang trong trạng thái thu gom.

service_status

Lưu ý: Chỉ có thể gửi các giá trị AWAITING_SERVICE và DO_NOT_DISTURB.

Giá Trị	Mô tả
AWAITING_SERVICE	Phòng đang chờ được dọn.
DO_NOT_DISTURB	Khách không muốn bị quấy rối.
VACANT_CLEANED	Phòng đã được dọn sạch và trống.
OCCUPIED_CLEANED	Phòng đã được dọn sạch và đang được sử dụng.
CLEANING_STARTED	Quá trình dọn phòng đã bắt đầu.
SERVICE_REFUSED	Khách đã từ chối dịch vụ.
STOPPED	Quá trình dọn phòng đã bị dừng lại.
TO_BE_INSPECTED	Phòng cần được kiểm tra.
INSPECTED	Phòng đã được kiểm tra.
LATE_SERVICE	Khách muốn dịch vụ muộn.
RETURN_LATER	Khách đã yêu cầu trở lại sau.