Status eines Door/Gate Controller abrufen

Ruft den zuletzt bekannten Zustand und die Basiskonfiguration eines einzelnen Door/Gate Controller ab.

Geben Sie eine Einrichtungskennung an, damit der Performance Hub prüfen kann, ob die Tür zu einer Einrichtung gehört, auf die Ihre Integration zugreifen darf.

Parameter

door_id string erforderlich

Die vom Listen-Endpunkt zurückgegebene ID des Door/Gate Controller.
facility_id string entweder/oderGeben Sie den für Ihre Integration konfigurierten Typ der Einrichtungskennung an: Verwenden Sie facility_id für Direct-Link-Integrationen oder linking_identifier für Linking-Identifier-Integrationen. Senden Sie nicht beide; die API verwendet den für Ihr Partnerkonto konfigurierten Kennungstyp und ignoriert den anderen. Weitere Informationen

Einrichtungs-ID des Performance Hub. Erforderlich für Direct-Link-Integrationen.
linking_identifier string entweder/oderGeben Sie den für Ihre Integration konfigurierten Typ der Einrichtungskennung an: Verwenden Sie facility_id für Direct-Link-Integrationen oder linking_identifier für Linking-Identifier-Integrationen. Senden Sie nicht beide; die API verwendet den für Ihr Partnerkonto konfigurierten Kennungstyp und ignoriert den anderen. Weitere Informationen

Einrichtungskennung des Partners. Erforderlich für Linking-Identifier-Integrationen.

Rückgabe

Gibt ein Door/Gate Controller-Objekt zurück.

Anfrage

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:

Antwort

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