Giao diện truyền thông với một Máy chủ Actabl Alice qua REST-API.
Giao diện chỉ chuyển dữ liệu phòng và không chuyển 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 Actabl. URL API là cố định và không thể thay đổi. Các phòng đã được xác định trước đó trong ứng dụng Actabl 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.
Lưu ý: Được khuyến cáo chuyển mỗi giá trị một lần mỗi ngày. Giao diện chỉ có thể gửi và không thể đọc giá trị.
Nếu xảy ra lỗi kết nối, yêu cầu sẽ được tự động lặp lại sau khi hết 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 nào được thiết lập trong thời gian chờ kết nối đã đặt, thì giao diện cũng sẽ được tuyên bố là ngoại tuyến.
Địa chỉ đích là địa chỉ của máy chủ mà không có URI và tiền tố https://.
Lưu ý: Khi sử dụng một máy chủ proxy, cần chú ý rằng đường dẫn URI không thay đổi.
Trình theo dõi có thể hiển thị nhiều nguồn khác nhau. Trong bảng sau sẽ giải thích tất cả các khả năng.
| Nguồn | Mô tả |
|---|---|
| Khách | Giá trị đến từ phía đối diện Actabl. |
| 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. |
| Tên | Kiểu dữ liệu | Mô tả |
|---|---|---|
| string | Đặt tên phòng theo giao diện. | |
| bool | Yêu cầu dọn phòng. | |
| bool | Gửi không quấy rối. |