Obtenir l'état d'un contrôleur de porte/portail
Récupère le dernier état connu et la configuration de base d'un contrôleur de porte/portail.
Fournissez un identifiant d'installation afin que Performance Hub puisse vérifier que la porte appartient à une installation à laquelle votre intégration a accès.
Paramètres
-
door_id
stringobligatoireID du contrôleur de porte/portail renvoyé par l'endpoint de liste.
-
facility_id
stringl'un ou l'autreIndiquez le type d'identifiant d'installation configuré pour votre intégration : utilisez facility_id pour les intégrations à liaison directe, ou linking_identifier pour les intégrations à identifiant de liaison. N'envoyez pas les deux ; l'API utilise le type d'identifiant configuré pour votre compte partenaire et ignore l'autre. En savoir plusID d'installation Performance Hub. Obligatoire pour les intégrations à liaison directe.
-
linking_identifier
stringl'un ou l'autreIndiquez le type d'identifiant d'installation configuré pour votre intégration : utilisez facility_id pour les intégrations à liaison directe, ou linking_identifier pour les intégrations à identifiant de liaison. N'envoyez pas les deux ; l'API utilise le type d'identifiant configuré pour votre compte partenaire et ignore l'autre. En savoir plusIdentifiant d'installation du partenaire. Obligatoire pour les intégrations à identifiant de liaison.
Valeur renvoyée
Renvoie un objet contrôleur de porte/portail.
Requête
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:
Réponse
{
"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"
}
}