本文へスキップ

クイックスタート

BioStar Airのデモサイトを設定し、対応デバイスを接続・登録してクラウドAPI連携をテストする方法をご案内します。 BioStar 2で作業した経験があるなら、多くの概念が馴染み深く感じられるでしょう。 BioStar Airは完全なクラウドベースのシステムです。

事前要件​

開始する前に次の項目を確認する。

  • 工場出荷時に初期化されたファームウェアを搭載したBioStar Air対応機器を用意する。

    • XP2-AIR、XS2-AIR、BEW3-AIR、BS3-AIR、BLN2-AIR

    • 機器は認定のSuprema販売代理店を通じて購入できる。

  • 機器はイーサネット経由でインターネットに接続されている必要がある。

  • ネットワークでアウトバウンドアクセスを許可する。

    • Port 443 (HTTPS)

    • Port 5671 (MQTT over TLS)

デモ環境とAPIキーの設定​

サインアップとログイン​

  1. BioStar Air Developer に移動する。

  2. 「サインアップ」をクリックし、フォームを記入して承認を待つ。

  3. 承認が完了したら、ユーザーのメールアドレスとパスワードを使って開発者ポータルにログインしてください。

情報

開発者ポータルのメールアドレスとパスワードはデモポータルでは使用できません。

デモアプリケーションの作成​

  1. 「API」→「Management」に移動する。

  2. 「+ Register」ボタンをクリックする。

  3. アプリケーションタイプをDemoに選択する。

  4. アプリケーション名を入力し、Registerボタンをクリックする。

  5. デモアプリケーションの登録が完了すると、site_info.csv ファイルをダウンロードできます。

情報

  • site_info.csv ファイルには、エイリアスのメールアドレスとパスワードが含まれています。

  • デモポータルにログインする際は、必ずこのエイリアスのメールアドレスとパスワードを使用してください。

  • 開発者ポータルにログインするためのメールアドレスとパスワードをデモポータルで使用しないでください。

APIキーの発行​

  1. 「API」→「Management」に移動する。

  2. 登録済みのアプリケーションをクリックしてください。

  3. 「API Management」までスクロールする。

  4. 「Add」ボタンをクリックする。

  5. 名前を入力して確認する。

  6. 生成されたAPIキーをコピーして安全に保存してください。

このAPIキーを使って、デモ環境へのAPIリクエストを認証できます。

デモポータルへのログイン​

  1. 開発者ポータルのメニューでDemo Portalをクリックするか、https://demo.airfobspace.com/login に直接アクセスしてください。

  2. site_info.csv ファイルに記載されているエイリアスのメールアドレスとパスワードでログインしてください。

情報

開発者ポータルにログインするためのメールアドレスとパスワードをデモポータルで使用しないでください。

デバイスの登録​

モバイル機器でBioStar Air Demo App（Android専用）を使用する。

  1. BioStar Air Developers に移動してデモアプリをダウンロードしてください。

  2. デモアプリを起動し、site_info.csv ファイルに記載されているエイリアスのメールアドレスとパスワードでログインしてください。

  3. Android端末をリーダーの近く（BLEの範囲内）に持っていく。

    • 「All Menu」→「Devices」で右上のボタンをタップする。

    • デバイスを検索してRegisterボタンをタップする。

  4. 機器が音を出して再起動し、登録済みデバイス一覧に表示される。

情報

デバイスはモバイルアプリを通じてのみ登録できる。 ウェブポータルでは登録できない。 APIベースの登録には、パートナーに提供されない暗号化証明書が必要である。

デバイス管理​

デモアプリまたはデモウェブポータルでデバイスを管理できる。

Demo vs Production​

  • Demoサイト（テスト用）は開発者ポータルから作成される。

  • Productionサイトはパートナーポータルから作成され、サイトID、ユーザーのメールアドレスおよびパスワードが必要となる。 Productionサイトは承認された販売店またはSupremaの支店のみが作成できる。

情報

  • ユーザーIDとアカウントIDは異なる。 混同しないこと。

  • 複数のサイトを管理する場合は、パスワードを安全に保管する。

  • 常に最新のBearerトークンを使用する。

  • ブラウザからコピーしたBearerトークンはPostmanで再利用できる。

サポートが必要ですか？​

Supremaのテクニカルサポートポータルでチケットを作成する。 https://support.supremainc.com

このページは役に立ちましたか？