Zutrittskontrolle

Die Partner API kann die Hardware des Door/Gate Controller des Performance Hub in Einrichtungen auslösen, in denen Ihre Integration aktiviert ist.

Verwenden Sie diese API, wenn Ihr Mitgliederverwaltungssystem bereits entschieden hat, dass eine Person eintreten darf. Der Performance Hub prüft weder Mitgliedschaftsstatus, Zutrittszeiten, Türzonenregeln, Betrugsprüfungen noch Sperrlogik. Ihr System bleibt für diese Entscheidungen maßgeblich.

Die Entriegelungsanfrage ist synchron. Der Performance Hub sendet den Befehl in Echtzeit an den Controller vor Ort und gibt 200 erst zurück, nachdem das Gerät bestätigt hat, dass das Relais physisch entriegelt hat. Die meisten Bestätigungen sollten innerhalb von 3-5 Sekunden erfolgen. Wenn innerhalb des Zeitlimits keine Bestätigung eingeht, gibt die API einen expliziten Fehler zurück.

Sie können auch einen Zutrittsversuch oder eine Ablehnung erfassen, die den Controller nie erreicht hat. Dieser Aufruf entriegelt die Tür nicht. Er schreibt ein Ereignis in die Zugriffsprotokolle von Door & Gate Access.

Endpunkte

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