APIとWebhookの活用例

入室に合わせた空調・照明の操作|扉が開いたら、その部屋の空調や照明を入れるしくみ

扉が暗証番号などで開いたら、その部屋の空調や照明を入れられます。
レンタルスペース・会議室・無人の店舗で、RemoteLOCKのWebhookを使う例です。空調や照明を外から操作できる機器やしくみがあることが前提です。
こんなとき

人が入ったときだけ空調と照明を入れられます

無人で貸している部屋では、空調や照明を入れたままにするか、予約の時間に合わせてタイマーを組むことになります。これでは、予約が取り消された時間や、来なかったお客様の時間にも電気を使います。Webhookで解錠の知らせを受けて機器を動かすようにすると、実際に扉が開いたときだけ、空調と照明が入ります。
しくみ

扉が開くと、受け口が機器に指示を送ります

解錠から空調・照明が入るまでの流れの図。1 利用者:暗証番号で扉を開ける。予約した人やスタッフが番号を使います。2 RemoteLOCK:解錠の知らせを送る。開いた扉のIDと時刻が入ります。3 貴社が作る受け口:扉のIDから部屋を割り出す。扉と部屋の対応表を持っておきます。4 貴社が作る受け口:空調と照明に指示を送る。外から操作できる機器やしくみに送ります。5 空調・照明:空調と照明が入る。切るのは終了の時刻などで決めます。「貴社が作る受け口」は、貴社か開発会社で作っていただく部分です
扉が開くと、RemoteLOCKから、登録した受け口(Webhook)に解錠の知らせが届きます。知らせには、開いた扉のIDと時刻が入っています。貴社で作る受け口のプログラムが、扉のIDから部屋を割り出し、その部屋の空調や照明を操作できる機器やビル管理のしくみに、入れる指示を送ります。扉のIDは、クラウド管理画面のURLで確かめられます(デバイスID(UUID)の確認)。
施錠の知らせは、オートロックで閉まったときにも届くため、退室の合図には使えません。切るほうは、予約の終了の時刻や、決めた時間がたったときに切るなど、機器の側で決めておきます。解錠から知らせが届くまでの時間は、お使いの扉と機器で試してお確かめください。
必要なもの

始める前に3つがそろっているかお確かめください

必要なもの 中身
アカウントとデバイス 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること
Webhookの登録 クラウド管理画面の「高度な機能」→「お知らせ機能」で、通知先と受け取るイベントを登録します(お知らせ機能)。Webhookを受けるだけなら、APIのご利用の手続き(NDA)は要りません
受け口のプログラム 知らせを受けて処理するプログラムは、貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません
気をつける点

作る前にお確かめいただきたいこと

  • 受け口は、HTTPSで受け、3秒以内に200番台を返す作りにしてください。失敗が続くとWebhookは無効になり、メールでお知らせします(Webhookの受け口の条件)
  • 機種によって受け取れるイベントが違います。すべての扉を対象にするときは、お知らせ機能の情報元を「アカウント」にしてください(お知らせ機能)
  • 受け口が止まっているあいだは、扉が開いても機器は動きません。部屋の側のスイッチでも入れられるようにしておいてください
始め方

まずはお知らせ機能で通知先をご登録ください

Webhookの通知先は、クラウド管理画面の「高度な機能」→「お知らせ機能」→「通知先」で登録し、受け取るイベントを選びます(お知らせ機能)。届く内容の例は Webhookでのイベント情報の取得 にあります。カギの発行などをAPIで自動にしたいときは、API資料のお申し込み からご請求ください。
関連する記事

最終更新

この記事は役に立ちましたか?

0人中0人がこの記事が役に立ったと言っています

記事で解決しないときは

問い合わせフォーム(24時間受付)か、お電話でご相談ください。