Alexa Smart Properties APIで開発を始める

Alexa Smart Properties APIで開発を始める

Alexa Smart Propertiesを使用するには、まず地域のAmazonビジネスアカウントを作成し、そのアカウントをAlexa Smart Propertiesに登録する必要があります。

Alexa Smart Propertiesに登録する

ステップ1： Amazonビジネスアカウントを作成する

  • Amazonビジネスアカウントを作成するには、Amazonビジネスに移動します。

ステップ2： Alexa Smart Propertiesに登録する

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

ステップ3a： マネジメントコンソールにアクセスする

Alexa Smart Propertiesマネジメントコンソールを使用すると、組織およびユニットの管理者ユーザーの追加や、組織の施設、ルーム、デバイス、スキル、連絡先の管理ができます。詳細については、Alexa Smart Propertiesマネジメントコンソールを使用するを参照してください。

ステップ3b： Alexa Smart Properties REST APIを使用する

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

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

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

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

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

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

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

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

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

Amazonビジネスアカウントを使用したLWAでのログインに成功したら、Alexa Smart Properties 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への登録が完了し、APIを使用できるようになりました。

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

最終更新日: 2023 年 11 月 30 日