Actabl Alice
این رابط با استفاده از API REST با یک سرور Actabl Alice ارتباط برقرار میکند.
عملکرد
این رابط فقط دادههای اتاق را ارسال میکند و رویدادها را ارسال نمیکند. اگر این مورد ضروری باشد، به پشتیبانی Antcas مراجعه کنید.
توجه: این رابط در زمان ارسال بسیار آهسته است. ممکن است کمی وقت بکشد تا مقدار در نماهنگ ظاهر شود.
پلیهای فردی توسط سرور Antcas از طریق HTTPS به پورتال Actabl انجام میشود. URL API ثابت تعیین شده و نمیتواند تغییر کند. در اینجا اتاقهایی که قبلاً در برنامه Actabl و در Config Antcas تعریف شدهاند، پرسش میشوند. حداکثر تعداد پرسشها به طور پیشفرض 30 پرسش در دقیقه است. سرور Antcas به طور سختگیرانه از سیاست تعیین شده پیروی میکند تا بار کار Gegenseite و شبکه را کاهش دهد. این معنی دارد که ممکن است چند دقیقه طول بکشد تا یک تغییر در سرور Antcas رخ دهد.
توجه: توصیه میشود هر مقدار را یکبار در روز ارسال کنید. این رابط فقط میتواند ارسال کند و نمیتواند مقادیر را خواند.
در صورت بروز خطای ارتباطی، پرسش پس از رسیدن به زمان انتظار خودکاراً تکرار میشود. پیام خطا تنها یکبار در نماهنگ ظاهر میشود. اگر ارتباطی در طول زمان انتظار تعیین شده برقرار نشود، رابط نیز به عنوان آفلاین اعلام میشود.
پیکربندی
آدرس مقصد آدرس سرور بدون URI و پیشوند https:// است.
توجه: هنگام استفاده از یک سرور پروکسی، باید توجه داشت که مسیر URI تغییر نکند.
نماهنگ
نماهنگ میتواند از منابع مختلف نمایش داده شود. در جدول زیر تمام امکانات توضیح داده شدهاند.
| منبع | توضیحات |
|---|---|
| Client | مقدار دریافتی از طرف مقابل Actabl. |
| Server | مقدار ارسالی یا خوانده شده توسط Antcas Control. |
| System | پیام سیستم عمومی. |
متغیرها
| نام | نوع داده | توضیحات |
|---|---|---|
| string | نام اتاق را مطابق با رابط تنظیم میکند. | |
| bool | درخواست تمیز کردن اتاق. | |
| bool | ارسال Do Not Disturb. |