Alexa Smart Properties for Hospitality APIで開発を始める


Alexa Smart Properties for Hospitality APIで開発を始める

Alexa Smart Properties for Hospitality APIを使用するには、まず地域のAmazonビジネスアカウントを作成し、そのアカウントをAlexa Smart Properties for Hospitalityに登録する必要があります。次に、Alexa Smart Properties for Hospitalityに登録したものと同じAmazonビジネスアカウントを使用して、Login with Amazon(LWA)セキュリティプロファイルを作成する必要があります。最後に、LWAセキュリティプロファイルをAlexa Smart Propertiesに登録し、そのセキュリティプロファイルを使用してAPIアクセストークンを生成する必要があります。

前提条件

Amazonビジネスアカウントを作成するには

  • Amazonビジネスアカウントを作成するには、Alexa Smart Properties for Hospitalityで開発を始めるためのセルフガイドチェックリストのステップ1に従います。

Alexa Smart Properties for Hospitalityに登録するには

  • 既にAlexa Smart Propertiesビジネス開発チームのメンバーと連携している場合は、前のステップを完了したことをお伝えいただくと、チームが代わってセットアップを完了します。
  • ビジネス開発チームと連携していない場合は、Alexa Smart Properties for HospitalityおよびAlexa Smart Properties for Residentialへのサインアップページからご連絡ください。ビジネス開発チームのメンバーが、以下の手順について折り返しご案内します。
    • 会社のAmazonビジネスアカウントのメールまたはカスタマーIDとビジネスIDを登録します。
    • 利用料金を確定します。
    • サブスクリプションの設定を完了します。

LWAセキュリティプロファイルを作成する

Alexa Smart Properties for Hospitalityに登録したものと同じAmazonビジネスアカウントとメールアドレスを使用して、LWAコンソールで以下の手順に従ってセキュリティプロファイルを作成します。後で参照できるように、アプリケーションのクライアントIDを書き留めておいてください。セキュリティプロファイルを作成したら、セキュリティプロファイルにウェブサイトを追加します。

LWAセキュリティプロファイルを登録して組織IDを取得する

Alexa Smart Propertiesコンソールにログインし、Administrationに移動します。Grant API Accessをクリックし、LWAクライアントIDを入力して、Submitをクリックします。これで、LWAセキュリティプロファイルが登録され、Alexa Smart Properties for Hospitality組織(amzn1.alexa.unit.did.{id})のIDが取得されます。

LWAと統合してAPIアクセストークンを取得する

LWAをアプリケーションに統合してAPIアクセストークンを取得するには、Login with Amazonとアプリを統合するの手順に従います。この手順は、LWAをアプリケーションに統合し、LWA APIアクセストークンを取得する方法を示しています。詳細については、Login with Amazon認可グラントを参照してください。

LWAと統合してAlexa Smart Properties for HospitalityのAPIアクセストークンを取得するには

  1. 認可グラントタイプとしてAuth Code Grantを選択します。
  2. "alexa::enterprise:management""credential_locker::wifi_management""profile:user_id"のスコープをリクエストします。

Amazonビジネスアカウントを使用したLWAでのログインに成功したら、Alexa Smart Properties for Hospitality APIを呼び出すことができます。

アクセストークンを更新するには、リフレッシュトークンの使用の手順に従います。

LWAアクセストークンを使用する

APIを呼び出すには、各API呼び出しの認可リクエストヘッダーにAPIアクセストークンを含める必要があります。

以下の例は、アクセストークンを使用してエンドポイントを列挙するAPIを呼び出すCURLリクエストです。これを使用するには、$ACCESS_TOKENを実際のアクセストークンに置き換え、呼び出すAPIに応じてURLを適切に変更してください。

   curl -i -v -X GET -H "Authorization: Bearer $ACCESS_TOKEN" https://api.amazonalexa.com/v2/endpoints

これでAlexa Smart Properties for Hospitalityへの登録が完了し、そのAPIを使用できるようになりました。


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

最終更新日: 2023 年 03 月 16 日