获取门/闸机控制器状态

检索单个门/闸机控制器的最新已知状态和基本配置。

请提供设施标识符，以便 Performance Hub 验证该门属于您的集成可以访问的设施。

参数

door_id string 必填

列表端点返回的门/闸机控制器 ID。
facility_id string 二选一请提供为您的集成配置的设施标识符类型：直接关联集成使用 facility_id，关联标识符集成使用 linking_identifier。请勿同时发送两者；API 会使用为您的合作伙伴账户配置的标识符类型，并忽略另一个。了解详情

Performance Hub 设施 ID。直接关联集成必填。
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"
  }
}