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 string obligatoire

    ID du contrôleur de porte/portail renvoyé par l'endpoint de liste.

  • facility_id string l'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 plus

    ID d'installation Performance Hub. Obligatoire pour les intégrations à liaison directe.

  • linking_identifier string l'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 plus

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