التحكم في الوصول

يمكن لـ Partner API تشغيل أجهزة وحدة التحكم في الأبواب/البوابات (Door/Gate Controller) من Performance Hub في المنشآت التي فُعّل فيها تكاملك.

استخدم واجهة API هذه عندما يكون نظام إدارة الأعضاء لديك قد قرر بالفعل أنه يُسمح لشخص ما بالدخول. لا يقيّم Performance Hub حالة العضوية، أو ساعات الوصول، أو قواعد مناطق الأبواب، أو فحوصات الاحتيال، أو منطق التعليق. ويظل نظامك هو الجهة المخوّلة باتخاذ هذه القرارات.

طلب فتح القفل متزامن. يرسل Performance Hub الأمر إلى وحدة التحكم في الموقع في الوقت الفعلي، ولا يُرجع 200 إلا بعد أن يؤكد الجهاز أن المرحّل فتح القفل فعليًا. ينبغي أن تكتمل معظم التأكيدات خلال 3-5 ثوانٍ. وإذا لم يُستلم أي تأكيد خلال فترة المهلة، تُرجع API إخفاقًا صريحًا.

يمكنك أيضًا تسجيل محاولة وصول أو رفض لم يصل إلى وحدة التحكم. لا يفتح هذا الاستدعاء قفل الباب، بل يكتب حدثًا في سجلات الوصول ضمن Door & Gate Access.

نقاط النهاية

GET /partner/v1/access-control/doors - List available Door/Gate Controllers
GET /partner/v1/access-control/doors/{door_id} - Get Door/Gate Controller status
POST /partner/v1/access-control/doors/{door_id}/unlock - Unlock a Door/Gate Controller
POST /partner/v1/access-control/doors/{door_id}/access-events - Record an access attempt or denial