Actabl Alice

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

آلية العمل

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

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

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

ملاحظة: ينصح بإرسال كل قيمة مرة واحدة في اليوم. لا يمكن للواجهة سوى الإرسال ولا يمكن قراءتها.

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

التكوين

عناوان الوجهة هو عنوان الخادم دون URI وprefix https://.

ملاحظة: عند استخدام خادم بروكسي، يجب التأكد من عدم تغيير مسار URI.

المراقب

يمكن للمراقب عرض مصادر مختلفة. في الجدول التالي، يتم شرح جميع الإمكانيات.

المصدر	الوصف
العميل	القيمة الواردة من الطرف المقابل لـ Actabl.
الخادم	القيمة المرسلة أو المقروءة بواسطة Antcas Control.
النظام	رسالة نظام عامة.

المتغيرات

الاسم	نوع البيانات	الوصف
id	string	يحدد اسم الغرفة وفقًا للواجهة.
make_up	bool	طلب تنظيف الغرفة.
dnd	bool	إرسال لا disturb.