ドア/ゲートコントローラーのステータスを取得する

1 台のドア/ゲートコントローラーについて、最新の既知の状態と基本的な設定を取得します。

ドアが連携からアクセス可能な施設に属していることを Performance Hub が確認できるよう、施設識別子を指定してください。

パラメーター

door_id string 必須

一覧エンドポイントから返されたドア/ゲートコントローラーの ID。
facility_id string いずれか一方連携に設定されている施設識別子の種類を指定してください。Direct Link の連携では facility_id を、Linking Identifier の連携では linking_identifier を使用します。両方を送信しないでください。API はパートナーアカウントに設定された識別子の種類を使用し、もう一方は無視します。詳細

Performance Hub の施設 ID。Direct Link の連携で必須です。
linking_identifier string いずれか一方連携に設定されている施設識別子の種類を指定してください。Direct Link の連携では facility_id を、Linking Identifier の連携では linking_identifier を使用します。両方を送信しないでください。API はパートナーアカウントに設定された識別子の種類を使用し、もう一方は無視します。詳細

パートナーの施設識別子。Linking Identifier の連携で必須です。

戻り値

ドア/ゲートコントローラーオブジェクトを返します。

リクエスト

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"
  }
}