ปลดล็อก Door/Gate Controller

ส่งคำสั่งปลดล็อกไปยัง Door/Gate Controller และรอให้รีเลย์ทางกายภาพยืนยันว่าปลดล็อกแล้ว

ระบบของคุณต้องตัดสินว่าบุคคลนั้นได้รับอนุญาตหรือไม่ก่อนเรียกปลายทางนี้ Performance Hub จะตรวจสอบเฉพาะคีย์พาร์ทเนอร์ การเข้าถึงสถานที่ ความเป็นเจ้าของประตู และสถานะของอุปกรณ์เท่านั้น

พารามิเตอร์

• door_id string จำเป็น

  ID ของ Door/Gate Controller ที่ส่งคืนจากปลายทางแสดงรายการ

• facility_id string อย่างใดอย่างหนึ่งระบุประเภทตัวระบุสถานที่ที่กำหนดค่าไว้สำหรับการผสานรวมของคุณ: ใช้ facility_id สำหรับการผสานรวมแบบ Direct Link หรือใช้ linking_identifier สำหรับการผสานรวมแบบ Linking Identifier อย่าส่งทั้งสองค่า API จะใช้ประเภทตัวระบุที่กำหนดค่าไว้สำหรับบัญชีพาร์ทเนอร์ของคุณและละเว้นอีกค่าหนึ่ง ดูข้อมูลเพิ่มเติม

  ID สถานที่ของ Performance Hub จำเป็นสำหรับการผสานรวมแบบ Direct Link

• linking_identifier string อย่างใดอย่างหนึ่งระบุประเภทตัวระบุสถานที่ที่กำหนดค่าไว้สำหรับการผสานรวมของคุณ: ใช้ facility_id สำหรับการผสานรวมแบบ Direct Link หรือใช้ linking_identifier สำหรับการผสานรวมแบบ Linking Identifier อย่าส่งทั้งสองค่า API จะใช้ประเภทตัวระบุที่กำหนดค่าไว้สำหรับบัญชีพาร์ทเนอร์ของคุณและละเว้นอีกค่าหนึ่ง ดูข้อมูลเพิ่มเติม

  ตัวระบุสถานที่ของพาร์ทเนอร์ จำเป็นสำหรับการผสานรวมแบบ Linking Identifier

• member_id string จำเป็น

  ID สมาชิกของพาร์ทเนอร์ ใช้สำหรับการบันทึกเพื่อการตรวจสอบและการเชื่อมโยงข้อมูลในภายหลัง

• first_name string จำเป็น

  ชื่อจริงของบุคคลที่เปิดประตู

• last_name string จำเป็น

  นามสกุลของบุคคลที่เปิดประตู

• full_name string ไม่บังคับ

  ไม่บังคับ หากเว้นไว้ Performance Hub จะรวม first_name และ last_name เข้าด้วยกัน

• check_in_id string ไม่บังคับ

  ID การเช็กอินจากระบบของคุณ (ไม่บังคับ) สำหรับการเชื่อมโยงข้อมูล

• idempotency_key string ไม่บังคับ

  คีย์ป้องกันการส่งซ้ำ (ไม่บังคับ) การใช้คีย์เดิมซ้ำสำหรับพาร์ทเนอร์ สถานที่ และประตูเดียวกันจะส่งคืนผลลัพธ์ที่มีอยู่เมื่อมี

ค่าที่ส่งคืน

ส่งคืน 200 ก็ต่อเมื่ออุปกรณ์ยืนยันว่ารีเลย์ปลดล็อกทางกายภาพแล้วเท่านั้น ประตูจะใช้ระยะเวลาค้างการปลดล็อกที่กำหนดค่าไว้ในการจัดการอุปกรณ์ของ Performance Hub พาร์ทเนอร์ไม่สามารถแทนที่ระยะเวลาของรีเลย์ในแต่ละคำขอได้ การยืนยันส่วนใหญ่ควรเสร็จสิ้นภายใน 3-5 วินาที ให้ถือว่าการหมดเวลาที่ระบุในเอกสารเป็นการปลดล็อกที่ล้มเหลวอย่างชัดเจน และลองใหม่ตามกฎด้านความปลอดภัยของคุณเองเท่านั้น

ความล้มเหลวที่พบบ่อย:

• 403 integration_not_enabled - ยังไม่ได้เปิดใช้การผสานรวมของคุณสำหรับสถานที่นั้น
• 409 maintenance_mode_active - เจ้าหน้าที่ของสถานที่เปิดใช้โหมดบำรุงรักษาสำหรับประตูนั้น
• 503 device_offline - Door/Gate Controller ออฟไลน์หรือข้อมูลไม่เป็นปัจจุบัน
• 504 unlock_confirmation_timeout - ส่งคำสั่งแล้วแต่ไม่ได้รับการยืนยันที่ตรงกันก่อนหมดเวลา

คำขอ

curl -X POST https://partner-api.performancehub.co/partner/v1/access-control/doors/00000000000000000000000000000007/unlock \
  -u sk_live_YOUR_PARTNER_SECRET_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "facility_id": "550e8400-e29b-41d4-a716-446655440000",
    "member_id": "mem_12345",
    "first_name": "Jane",
    "last_name": "S.",
    "full_name": "Jane S.",
    "source": "door_reader",
    "idempotency_key": "unlock_20260501_0001"
  }'

การตอบกลับ

{
  "status": "unlocked",
  "door_id": "00000000000000000000000000000007",
  "facility_id": "550e8400-e29b-41d4-a716-446655440000",
  "event_id": "00000000-0000-0000-0000-000000000045",
  "command_id": "00000000-0000-0000-0000-000000000049",
  "hold_time_seconds": 10,
  "confirmed_at": "2026-05-01T04:30:00.000Z"
}

การตอบกลับเมื่อล้มเหลว

{
  "status": "failed",
  "reason": "device_offline",
  "door_id": "00000000000000000000000000000007",
  "facility_id": "550e8400-e29b-41d4-a716-446655440000",
  "event_id": "00000000-0000-0000-0000-000000000045"
}