Controle de acesso

A Partner API pode acionar o hardware Door/Gate Controller do Performance Hub nas instalações em que sua integração está ativada.

Use esta API quando o seu sistema de gestão de membros já tiver decidido que uma pessoa tem permissão para entrar. O Performance Hub não avalia o status da associação, os horários de acesso, as regras de zonas de portas, as verificações antifraude nem a lógica de suspensão. Seu sistema continua sendo a autoridade para essas decisões.

A solicitação de destravamento é síncrona. O Performance Hub envia o comando ao controlador local em tempo real e retorna 200 somente depois que o dispositivo confirma que o relé foi fisicamente destravado. A maioria das confirmações deve ser concluída em 3-5 segundos. Se nenhuma confirmação for recebida dentro do tempo limite, a API retorna uma falha explícita.

Você também pode registrar uma tentativa ou negação de acesso que nunca chegou ao controlador. Essa chamada não destrava a porta. Ela grava um evento nos Registros de acesso do Door & Gate Access.

Endpoints

GET /partner/v1/access-control/doors - List available Door/Gate Controllers
GET /partner/v1/access-control/doors/{door_id} - Get Door/Gate Controller status
POST /partner/v1/access-control/doors/{door_id}/unlock - Unlock a Door/Gate Controller
POST /partner/v1/access-control/doors/{door_id}/access-events - Record an access attempt or denial