アクセスコントロール

Partner API を使用すると、連携が有効になっている施設で Performance Hub のドア/ゲートコントローラーのハードウェアを動作させることができます。

この API は、会員管理システムが人物の入場を許可するとすでに判断した場合に使用します。Performance Hub は、会員ステータス、アクセス時間、ドアゾーンのルール、不正チェック、利用停止のロジックを評価しません。これらの判断は、引き続きお使いのシステムが行います。

解錠リクエストは同期的に処理されます。Performance Hub はコマンドを現地のコントローラーにリアルタイムで送信し、リレーが物理的に解錠されたことをデバイスが確認した後にのみ 200 を返します。ほとんどの確認は 3〜5 秒で完了します。タイムアウト時間内に確認を受け取れなかった場合、API は明示的な失敗を返します。

コントローラーに到達しなかったアクセスの試行や拒否を記録することもできます。この呼び出しではドアは解錠されません。ドア/ゲートアクセスのアクセスログにイベントが書き込まれます。

エンドポイント

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