Amadeus HotSOS

الواجهة تتواصل مع خادم Amadeus HotSOS عبر واجهة برمجة التطبيقات REST.

كيفية العمل

تنسق الواجهة بيانات الغرف فقط ولا تتعامل مع الأحداث. إذا كان ذلك ضروريًا، يرجى الاتصال بدعم Antcas.

ملاحظة: الواجهة بطيئة جدًا عند الإرسال. قد يستغرق الأمر Moment حتى يظهر القيمة في المراقب.

يتم إجراء استعلامات فردية من خادم Antcas عبر HTTPS إلى بوابة HotSOS. يتم تحديد عنوان URL للواجهة البرمجية بشكل ثابت ولا يمكن تغييره. يتم استعلام الغرف التي تم تعريفها مسبقًا في تطبيق HotSOS وفي Antcas Config. يبلغ الحد الأقصى للاستعلامات 30 استعلامًا في الدقيقة. يحافظ خادم Antcas على سياسة محددة بدقة لتقليل التحميل على الطرف الآخر وشبكة الإنترنت. وهذا يعني أنه قد يستغرق بعض الوقت حتى تصل التغييرات إلى خادم Antcas.

عند بدء تشغيل الخادم، يتم استرجاع الرسائل أولاً ثم نقل جميع رسائل الحالة. إذا حدث تغيير مؤقتًا من جانب HotSOS، فإن هذا يؤدي إلى وصول الحالة أولاً إلى PLC ثم إعادة الإرسال.

إذا حدث خطأ في الاتصال، يتم تكرار الاستعلام تلقائيًا بعد الوصول إلى وقت الانتظار. تظهر رسالة الخطأ مرة واحدة فقط في المراقب. إذا لم يتم إنشاء اتصال خلال وقت انتظار الاتصال المحدد، يتم أيضًا إعلان الواجهة كغير متصلة بالإنترنت.

التكوين

عناوان الوجهة هو عنوان الخادم دون URI وprefix 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	طلب الضيف العودة لاحقًا.