【RemoteLOCK API・重要】GET /events エンドポイント廃止のお知らせ

RemoteLOCK APIご利用のお客様・連携パートナーの皆様

平素より「RemoteLOCK API」をご利用いただきありがとうございます。

この度、RemoteLOCKのイベント一覧を取得するエンドポイント（GET /events）を廃止させていただくことになりましたのでお知らせいたします。

【廃止予定時期】2025年12月末

【廃止対象のエンドポイント】GET /events

【推奨する代替策】イベントの取得にはRemoteLOCKからのプッシュするWebhook通知をご利用ください。

Webhookのご利用について

Webhookは管理画面から設定が可能です。またAPIからは次の手順で通知設定いただけます。

1. Webhook通知先の登録エンドポイントPOST /notification_subscribersにて通知先を登録する
   1. "type"はwebhook_notification_subscriberを指定する
2. お知らせの登録エンドポイントPOST /notification_subscriptionsにて通知設定いただく

   1. "event_type"

      1. デバイスの解錠施錠に関わるもの：unlocked, locked
      2. アクセスユーザー・ゲストの操作に関わるもの：access_person_used, access_denied
      3. PINコードなどの認証情報の状態に関わるもの：access_person_synced, access_person_sync_failed, access_guest_late_sync
      4. デバイスのアラートに関わるもの：connectivity, power_level_low

      ※アクセスユーザー・ゲストによる解錠イベントでは、unlockedと access_person_usedの両方が通知されます。ご注意ください。

   2. "publisher_type"
      1. アカウント内の全デバイス情報を同じ通知先に送りたい場合：account
      2. デバイス毎に通知先を分けたい場合：lock (TOBIRAの場合はacs_door, 新機種500i, 700iの場合はconnector_lock）としてデバイス毎に設定
   3. "publisher_id"
      1. accountの場合：account_id
      2. デバイスの場合：各デバイスのuuid
   4. "subscriber_type"：webhook_notification_subscriber
   5. subscriber id： 上記の手順1で登録した通知先を指定

併せて、無効なWebhook通知の停止処理がございますので、ご一読・ご確認のほどよろしくお願いいたします。

ご不明な点がございましたら、RemoteLOCK API担当 <remotelock-dev@remotelock.co.jp>までご連絡ください。

2025年7月16日公開　RemoteLOCK API担当