Amadeus HotSOS

อินเตอร์เฟซนี้สื่อสารกับ Amadeus HotSOS Server ผ่าน REST-API.

การทำงาน

อินเตอร์เฟซนี้จะซิงโครไนซ์ข้อมูลห้องเท่านั้น ไม่รวมเหตุการณ์ หากมีความต้องการในส่วนนี้ กรุณาติดต่อทีมสนับสนุนของ Antcas.

หมายเหตุ: อินเตอร์เฟซนี้ช้ามากเมื่อส่งข้อมูล อาจใช้เวลาหน่อยให้ค่าที่แสดงในโมนิเตอร์ปรากฏขึ้น

Antcas Server จะทำการ Poll ข้อมูลจาก HotSOS-Portal ผ่าน HTTPS URL ของ API ถูกกำหนดไว้แต่ไม่สามารถเปลี่ยนแปลงได้ ระบบจะสอบถามข้อมูลห้องที่ได้รับการกำหนดใน HotSOS และ Antcas Config ก่อนหน้านี้ จำนวน Poll ที่จำกัดอยู่ที่ 30 ครั้งต่อนาที ตามค่าเริ่มต้น Antcas Server จะปฏิบัติตามนโยบายที่ตั้งไว้เพื่อลดการใช้งานของฝ่ายตรงข้ามและเครือข่าย ซึ่งหมายความว่าอาจใช้เวลาหน่อยให้การเปลี่ยนแปลงใน Antcas Server ส่งผลต่อระบบ

เมื่อเริ่มต้นเซิร์ฟเวอร์ ระบบจะดึงข้อมูลสถานะและส่งข้อมูลสถานะทั้งหมด ถ้ามีการเปลี่ยนแปลงจากฝ่าย HotSOS ระหว่างการทำงาน สถานะจะถูกส่งไปยัง PLC ก่อน และถูกส่งอีกครั้ง

เมื่อเกิดข้อผิดพลาดในการเชื่อมต่อ การสอบถามจะถูกทำซ้ำโดยอัตโนมัติหลังจากหมดเวลาที่กำหนด การแจ้งเตือนข้อผิดพลาดจะปรากฏในโมนิเตอร์เพียงครั้งเดียว หากไม่สามารถเชื่อมต่อได้ภายในเวลา Timeout ที่ตั้งไว้ ระบบจะประกาศว่าอินเตอร์เฟซอยู่ในสถานะออฟไลน์

การกำหนดค่า

ที่อยู่ปลายทางคือที่อยู่ของเซิร์ฟเวอร์โดยไม่มี URI และ https://-prefix.

หมายเหตุ: เมื่อใช้ Proxy-Server ต้องตรวจสอบให้แน่ใจว่าประเภท URI ไม่เปลี่ยนแปลง

โมนิเตอร์

โมนิเตอร์สามารถแสดงข้อมูลจากหลายๆ แหล่ง ข้อมูลทั้งหมดจะถูกอธิบายในตารางต่อไปนี้

แหล่งที่มา	คำอธิบาย
Client	ค่าที่ได้รับจาก HotSOS
Server	ค่าที่ส่งหรืออ่านโดย Antcas Control
System	ข้อความแจ้งเตือนระบบทั่วไป

ตัวแปร

ชื่อ	ประเภทข้อมูล	คำอธิบาย
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	ลูกค้าขอให้กลับมาที่หลัง