APIとWebhookの活用例

直前の予約に間に合う暗証番号の発行|プールPINで、扉との通信を待たずに使える番号を渡すしくみ

直前に入った予約でも、扉との通信を待たずに使える暗証番号を渡せます。
時間貸しの施設や、夜間に無人で運営する施設で、予約APIとプールPINを組み合わせる例です。
こんなとき

予約から入室までが短くても番号が間に合います

APIで作った暗証番号が扉に届くのは、本体が次にクラウドと通信したときです(ハートビート通信のしくみ)。予約から入室までが短いと、利用者が着いた時点で番号がまだ扉に届いておらず、開けられないことがあります。プールPINを設定しておくと、対象の機種では、直前の予約に扉に届いている番号が渡されます。
しくみ

前もって扉に届けておいた番号を、予約に割り当てます

直前の予約から入室までの流れの図。1 施設の管理者:プールの数と通信の間隔を設定。Bookings API設定で一度だけ行います。2 RemoteLOCK:予備の暗証番号を扉に届けておく。ハートビートのたびに同期します。3 予約する人:開始の直前に予約を入れる。番号が扉に届くのを待てない予約です。4 貴社が作る連携:予約の内容をAPIで送る。送る内容はふだんの予約と同じです。5 RemoteLOCK:届けておいた番号を払い出す。通信を待たずにカギのURLを返します。6 予約する人:すぐに暗証番号で開ける。URLの画面に番号が出ます。「貴社が作る連携」は、貴社か開発会社で作っていただく部分です
クラウド管理画面の「Bookings API設定」で、1デバイスあたりの使用プール数とハートビート間隔を設定しておくと、RemoteLOCKは予備の暗証番号を作り、ハートビートのたびに扉に届けておきます。開始が近い予約をAPIで作ると、RemoteLOCKは届けておいた番号の1つをその予約に割り当て、カギのURL(ユニバーサルアクセスキー)を返します。プールPINを使うかどうかはRemoteLOCKが開始の時刻を見て自動で選ぶため、連携のプログラムで送る内容は変わりません。
使った分の番号はクラウドの側で補充され、扉に届くのは次のハートビートです。暗証番号やQRコードの値を指定して作った予約と、番号の再発行には、プールPINは使われません。対象の機種や、使われたかどうかの見分け方は プールPIN にまとめています。
※ お使いの予約システムがすでにRemoteLOCKと連携している場合は、開発は要りません。連携済みのサービスは 予約エンドポイントに対応した連携サービス と 連携システム一覧(公式サイト)でご覧いただけます。
必要なもの

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

必要なもの 中身
料金プラン ビジネス スタンダード以上で、お支払いが有効なこと(ご利用までの手続き)
アカウントとデバイス 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること
契約 機密保持契約(NDA)。APIのご利用に必要です。API利用料はかかりません
連携のプログラム 貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません
Bookings API設定 クラウド管理画面の「システム連携」→「Bookings API設定」で、使用プール数とハートビート間隔を入れます(Bookings API設定)
気をつける点

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

  • APIを呼べる回数には上限があります。予約をまとめて作るときは、間隔をあけて送ってください
  • ハートビート間隔は、Bookings API設定とデバイスの設定の両方に入れます。Bookings API設定には、アカウントでいちばん長い間隔を入れてください
  • 直前の予約が続く施設では、1日1部屋あたりに使う最大の数を目安に、プールの数を決めてください
  • プールPINは、直前の予約や一時的な通信のトラブルに備える機能です。扉のWi-Fiなどの通信環境が要らなくなるわけではありません
始め方

まずはAPI資料をお申し込みください

API資料のお申し込み からご請求いただくと、概要資料と、機密保持契約(NDA)の手続きのご案内をお送りします。NDAの締結後に、API仕様書と、動作を確かめるためのサンプルのアカウントとデバイスの情報をお送りします。手続きの流れは RemoteLOCK APIのご利用までの手続き に、そのほかの使い方は RemoteLOCK APIでできること にまとめています。
関連する記事

最終更新

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

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

記事で解決しないときは

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