Alexaスキルの認証情報API



Alexaスキルの資格情報APIは、クライアントの資格情報を返します。具体的には、スキルのclientIdとclientSecretです。これらの資格情報は、ユーザーの認証トークンを取得するために使用できます。認証トークンは、スキルメッセージAPIからアクセストークンを取得するために使用します。

ワークフローは次のようになります。

• スキルのサービスコードがLWAを呼び出してアクセストークンを取得します。

• その後、このトークンはSMAPI APIの呼び出しを認可するために使用されます。

• SMAPI APIの呼び出しが認可されると、特定のskillIdに対するクライアント資格情報が返されます。応答には、skillMessagingCredentialsが含まれます。これは、スキルが承認された権限にアクセスできるようにするために使われる、ユーザー認証トークンの取得に使用されます。

このAPIのエンドポイントは、https://api.amazonalexa.comです。すべてのAPIリクエストにはAuthorizationヘッダーが必要であり、その値はLogin with Amazonから取得したアクセストークンでなければなりません。

• GET
  • リクエスト
    • リクエストヘッダー
    • リクエスト本文
  • 応答
    • 応答のヘッダー
    • 応答の本文
  • エラー応答の処理（ステータスコード）

GET

指定したスキルのスキル資格情報を取得します。

HTTP/1.1

GET /v1/skills/{skillId}/credentials 

リクエスト

リクエストヘッダー

  Content-Type: application/json
  Accept: application/json
  Authorization: string

リクエスト本文

本文は空です。

応答

応答のヘッダー

Content-Type: application/json
X-Amzn-RequestId: string
X-Amzn-Authorization: string

応答の本文

{
  "skillMessagingCredentials": {
    "clientId": "<String>",
    "clientSecret": "<String>"
  }
}

エラー応答の処理（ステータスコード）