Controllo degli accessi

La Partner API può attivare l'hardware Door/Gate Controller del Performance Hub nelle strutture in cui la tua integrazione è attivata.

Usa questa API quando il tuo sistema di gestione dei membri ha già deciso che una persona può entrare. Il Performance Hub non valuta lo stato dell'abbonamento, gli orari di accesso, le regole delle zone delle porte, i controlli antifrode o la logica di sospensione. Il tuo sistema resta l'autorità per queste decisioni.

La richiesta di sblocco è sincrona. Il Performance Hub invia il comando al controller in loco in tempo reale e restituisce 200 solo dopo che il dispositivo ha confermato che il relè si è fisicamente sbloccato. La maggior parte delle conferme dovrebbe arrivare entro 3-5 secondi. Se non riceve alcuna conferma entro il tempo limite, l'API restituisce un errore esplicito.

Puoi anche registrare un tentativo di accesso o un rifiuto che non ha mai raggiunto il controller. Questa chiamata non sblocca la porta, ma scrive un evento nei Registri di accesso di Door & Gate Access.

Endpoint

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