الحصول على حالة وحدة التحكم في الباب/البوابة

يسترجع آخر حالة معروفة والتهيئة الأساسية لوحدة تحكم واحدة في باب/بوابة.

قدّم معرّف منشأة حتى يتمكن Performance Hub من التحقق من أن الباب ينتمي إلى منشأة يمكن لتكاملك الوصول إليها.

المعلمات

• door_id string مطلوب

  معرّف وحدة التحكم في الباب/البوابة الذي تُرجعه نقطة نهاية القائمة.

• facility_id string أحدهماقدّم نوع معرّف المنشأة المهيّأ لتكاملك: استخدم facility_id لتكاملات الربط المباشر، أو linking_identifier لتكاملات معرّف الربط. لا ترسل كليهما؛ إذ تستخدم API نوع المعرّف المهيّأ لحساب الشريك الخاص بك وتتجاهل الآخر. اعرف المزيد

  معرّف المنشأة في Performance Hub. مطلوب لتكاملات الربط المباشر.

• linking_identifier string أحدهماقدّم نوع معرّف المنشأة المهيّأ لتكاملك: استخدم facility_id لتكاملات الربط المباشر، أو linking_identifier لتكاملات معرّف الربط. لا ترسل كليهما؛ إذ تستخدم API نوع المعرّف المهيّأ لحساب الشريك الخاص بك وتتجاهل الآخر. اعرف المزيد

  معرّف المنشأة لدى الشريك. مطلوب لتكاملات معرّف الربط.

القيم المُرجعة

يُرجع كائن وحدة التحكم في الباب/البوابة.

الطلب

curl -X GET "https://partner-api.performancehub.co/partner/v1/access-control/doors/00000000000000000000000000000007?facility_id=550e8400-e29b-41d4-a716-446655440000" \
  -u sk_live_YOUR_PARTNER_SECRET_KEY:

الاستجابة

{
  "data": {
    "door_id": "00000000000000000000000000000007",
    "facility_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Front Door",
    "zone": "Entrance",
    "status": "online",
    "relay_state": "locked",
    "maintenance_mode": "off",
    "hold_time_seconds": 10,
    "last_seen": "2026-05-01T04:30:00.000Z"
  }
}