運営を任されている複数の施設のRemoteLOCKアカウントを、1つのOAuthアプリでつないで、まとめて扱えます。
運営代行の会社や、フランチャイズの本部などで、施設ごとに分かれたアカウントを自社のシステムから扱う例です。
こんなとき
施設ごとのアカウントを、自社のシステムからまとめて扱えます
施設ごとにアカウントが分かれていると、番号の発行や確認のたびに、それぞれのクラウド管理画面にログインし直すことになります。ログイン情報を預かって代わりに操作すると、パスワードの管理も負担になります。RemoteLOCK APIの認証はOAuth 2.0で、複数のアカウントと連携するクラウドサービス向けの方式なら、1つのOAuthアプリで複数のアカウントとつなげます。施設のオーナーに許可してもらえば、トークンを更新し続けるかぎり、自社のシステムから施設ごとにAPIを呼べます。
しくみ
施設のオーナーが許可すると、その施設のアカウントを扱えます
自社のシステムで連携を始めると、施設のオーナーはRemoteLOCKのログイン画面に移り、ログインして連携を「許可」します。許可すると、そのアカウントのトークンが自社のシステムに渡り、以後は施設を選んでAPIを呼べます。オーナーのパスワードを本部が預かる必要はありません（システム連携とOAuthアプリの登録申請）。
トークンは施設ごとに別なので、どの施設のものかを分けて保管し、APIを呼ぶときに施設を取り違えないようにします。アクセストークンとリフレッシュトークンには有効期限があるため、施設ごとに定期的に更新する処理を入れておきます（APIの認証エラーとタイムアウト）。
必要なもの
始める前に5つがそろっているかお確かめください
| 必要なもの | 中身 |
| 料金プラン | ビジネス スタンダード以上で、お支払いが有効なこと（ご利用までの手続き） |
| アカウントとデバイス | 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること |
| 契約 | 機密保持契約（NDA）。APIのご利用に必要です。API利用料はかかりません |
| 連携のプログラム | 貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません |
| OAuthアプリ | 自社のシステム用に1つ登録します（登録のしかたはAPI仕様書をご覧ください） |
気をつける点
作る前にお確かめいただきたいこと
- 連携する施設のアカウントも、それぞれビジネス スタンダード以上で、お支払いが有効である必要があります
- トークンやクライアントシークレットは、施設の数だけカギを預かっているのと同じです。チャットや共有の表に貼らず、見られる人を絞って保管してください
- APIを呼べる回数には上限があります。施設をまとめて処理するときは、間隔をあけて順に送ってください
始め方
まずはAPI資料をお申し込みください
API資料のお申し込み からご請求いただくと、概要資料と、機密保持契約（NDA）の手続きのご案内をお送りします。NDAの締結後に、API仕様書と、動作を確かめるためのサンプルのアカウントとデバイスの情報をお送りします。手続きの流れは RemoteLOCK APIのご利用までの手続き に、そのほかの使い方は RemoteLOCK APIでできること にまとめています。
関連する記事