门禁控制
对于已启用您的集成的设施,Partner API 可以触发 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