Ottenere lo stato di un Door/Gate Controller

Recupera l'ultimo stato noto e la configurazione di base di un singolo Door/Gate Controller.

Indica un identificatore della struttura, in modo che il Performance Hub possa verificare che la porta appartenga a una struttura a cui la tua integrazione ha accesso.

Parametri

• door_id string obbligatorio

  ID del Door/Gate Controller restituito dall'endpoint di elenco.

• facility_id string in alternativaIndica il tipo di identificatore della struttura configurato per la tua integrazione: usa facility_id per le integrazioni con collegamento diretto oppure linking_identifier per le integrazioni con identificatore di collegamento. Non inviarli entrambi: l'API usa il tipo di identificatore configurato per il tuo account partner e ignora l'altro. Scopri di più

  ID della struttura nel Performance Hub. Obbligatorio per le integrazioni con collegamento diretto.

• linking_identifier string in alternativaIndica il tipo di identificatore della struttura configurato per la tua integrazione: usa facility_id per le integrazioni con collegamento diretto oppure linking_identifier per le integrazioni con identificatore di collegamento. Non inviarli entrambi: l'API usa il tipo di identificatore configurato per il tuo account partner e ignora l'altro. Scopri di più

  Identificatore della struttura del partner. Obbligatorio per le integrazioni con identificatore di collegamento.

Valore restituito

Restituisce un oggetto Door/Gate Controller.

Richiesta

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:

Risposta

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