Amadeus HotSOS

این رابط با استفاده از API REST با یک سرور Amadeus HotSOS ارتباط برقرار می‌کند.

عملکرد

این رابط فقط داده‌های اتاق را همگام‌سازی می‌کند و رویدادها را همگام‌سازی نمی‌کند. اگر این مورد ضروری باشد، به پشتیبانی Antcas مراجعه کنید.

توجه: این رابط در زمان ارسال بسیار آهسته است. ممکن است کمی وقت بکشد تا مقدار در نماهنگ ظاهر شود.

پلی‌های فردی از سرور Antcas به طریق HTTPS به پورتال HotSOS انجام می‌شود. URL API ثابت تعیین شده و نمی‌تواند تغییر کند. در اینجا اتاق‌هایی که قبلاً در برنامه HotSOS و در Config Antcas تعریف شده‌اند، پرسش می‌شوند. حداکثر تعداد پرسش‌ها در هر دقیقه به طور پیش‌فرض 30 است. سرور Antcas به سیاست تعیین‌شده پایبند است تا بار کار Gegenseite و شبکه را کاهش دهد. این معنی دارد که ممکن است چند دقیقه طول بکشد تا یک تغییر در سرور Antcas دریافت شود.

در زمان راه‌اندازی سرور، ابتدا پیام‌ها دریافت می‌شوند و سپس همه وضعیت‌های پیام ارسال می‌شوند. اگر در بین این دو تغییری از طرف HotSOS رخ دهد، نتیجه آن این خواهد بود که وضعیت ابتدا به SPS می‌رسد و سپس دوباره ارسال می‌شود.

اگر خطا در ارتباط رخ دهد، پرسش پس از رسیدن به زمان انتظار خودکاراً تکرار می‌شود. پیام خطا تنها یک بار در نماهنگ ظاهر می‌شود. اگر ارتباطی در زمان انتظار تعیین‌شده برقرار نشود، رابط نیز به عنوان آفلاین اعلام می‌شود.

پیکربندی

آدرس مقصد آدرس سرور بدون URI و پیشوند https:// است.

توجه: در هنگام استفاده از یک سرور پروکسی، باید توجه داشت که مسیر 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	مهمان برای بازگشت در زمان بعد درخواست داده است.