Obtener el estado de un controlador de puertas y portones

Recupera el último estado conocido y la configuración básica de un solo controlador de puertas y portones.

Proporciona un identificador de instalación para que el Performance Hub pueda verificar que la puerta pertenece a una instalación a la que tu integración tiene acceso.

Parámetros

  • door_id string obligatorio

    ID del controlador de puertas y portones que devuelve el endpoint de lista.

  • facility_id string uno u otroIndica el tipo de identificador de instalación configurado para tu integración: usa facility_id en las integraciones de vinculación directa o linking_identifier en las integraciones con identificador de vinculación. No envíes ambos; la API usa el tipo de identificador configurado para tu cuenta de socio e ignora el otro. Más información

    ID de instalación del Performance Hub. Obligatorio en las integraciones de vinculación directa.

  • linking_identifier string uno u otroIndica el tipo de identificador de instalación configurado para tu integración: usa facility_id en las integraciones de vinculación directa o linking_identifier en las integraciones con identificador de vinculación. No envíes ambos; la API usa el tipo de identificador configurado para tu cuenta de socio e ignora el otro. Más información

    Identificador de instalación del socio. Obligatorio en las integraciones con identificador de vinculación.

Valor devuelto

Devuelve un objeto de controlador de puertas y portones.

Solicitud

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:

Respuesta

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