ユーザーAPIリファレンス
ユーザーAPIを使用すると、ユーザーの表現の作成、削除、リスト取得を行うことができます。
APIエンドポイント
リクエストヘッダーでは、組織が所在する地域に応じて、Host
をhttps://api.amazonalexa.com
に設定してください。
認証
すべてのAPIリクエストにはAuthorizationヘッダーが必要であり、その値にはLogin with Amazon(LWA)から取得したアクセストークンが入ります。
操作
ユーザーAPIには、以下の操作が用意されています。
操作 | HTTPメソッドとURI |
---|---|
| |
| |
|
ユーザーを作成する
指定した組織にユーザーを作成します。
この操作は以下の国で使用できます。
Healthcare | Hospitality | Senior Living | Core |
---|---|---|---|
なし |
米国、カナダ |
米国、カナダ |
米国、カナダ |
リクエスト
ユーザーを作成するには、/v1/auth/users
リソースに対してPOST
リクエストを実行します。
リクエストヘッダーの例
POST /v1/auth/users HTTP/1.1
Host: api.amazonalexa.com
Content-Type: application/json
Authorization: Bearer {access token}
リクエストヘッダーのパラメーター
パラメーター | 説明 | 型 | 必須 |
---|---|---|---|
|
文字列 |
◯ |
リクエスト本文の例
{
"organizationId": "amzn1.alexa.org.did.exampleId"
}
リクエスト本文のパラメーター
パラメーター | 説明 | 型 | 必須 |
---|---|---|---|
|
ユーザーを追加する組織のID。組織IDは |
文字列 |
◯ |
応答
正常に完了すると、HTTP 201が返されます。
応答本文の例
以下は、成功した応答の本文の例です。
{
"userId": "amzn1.alexa.org.user.did.ABCGHLLKJKJHGHGHJ",
"accessToken": "Atza|ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"refreshToken": "Atzr|ABCDEFGHIJKLMNOPQRSTUVWXYZ"
}
応答本文のパラメーター
パラメーター | 説明 | 型 |
---|---|---|
|
追加したユーザーのID。 |
文字列 |
|
追加したユーザーを表すトークン。このトークンは後続のAPI呼び出しに使用します。 |
文字列 |
|
追加したユーザーを表す更新トークン。このトークンはアクセストークンを更新するために使用します。 |
文字列 |
HTTPステータスコード
ステータス | 説明 |
---|---|
|
ユーザーが正常に作成されました。 |
|
呼び出し元が指定された組織に含まれていません。 |
|
組織IDが無効です。 |
|
認可トークンが無効または期限切れか、リソースに対するアクセス権限が認可トークンにありません。 |
|
操作を実行する権限が呼び出し元にありません。 |
|
呼び出し元が、許可されたレート制限(単位時間あたりの指定されたリクエスト数)を超過しています。 |
|
サーバーでエラーが発生しました。 |
|
サーバーがメンテナンスのために停止しているか、過負荷状態または受信リクエストを処理できない状態になっています。 |
ユーザーのリストを取得する
指定した組織のユーザーのリストを取得します。
この操作は以下の国で使用できます。
Healthcare | Hospitality | Senior Living | Core |
---|---|---|---|
なし |
米国、カナダ |
米国、カナダ |
米国、カナダ |
リクエスト
ユーザーのリストを取得するには、/v1/auth/users
リソースに対してGETリクエストを実行します。
リクエストヘッダーの例
GET /v1/auth/users?organizationId={organizationId}&maxResults={maxResults}&nextToken={nextToken} HTTP/1.1
Host: api.amazonalexa.com
Content-Type: application/json
Authorization: Bearer {access token}
リクエストヘッダーのパラメーター
パラメーター | 説明 | 型 | 必須 |
---|---|---|---|
|
文字列 |
◯ | |
|
ユーザーのリストを取得する組織のID。組織IDは |
文字列 |
◯ |
|
応答本文で返される結果の最大数。10以下の正の値を指定してください。デフォルト値は10です。詳細については、クエリ結果のページ分割を処理するを参照してください。 |
数値 |
✕ |
|
ページ分割された結果から特定のページを取得するためのトークン。このトークンがない場合、応答には結果の先頭ページが含められます。詳細については、クエリ結果のページ分割を処理するを参照してください。 |
文字列 |
✕ |
リクエスト本文の例
リクエストの本文はありません。
リクエスト本文のパラメーター
リクエストの本文はありません。
応答
正常に完了すると、ユーザーのリストと共にHTTP 200が返されます。
応答本文の例
以下は、成功した応答の本文の例です。
{
"results": [
{
"userId": "amzn1.alexa.org.user.did.12345EXAMPLE"
}
],
"paginationContext": {
"nextToken": null
}
}
応答本文のパラメーター
パラメーター | 説明 | 型 |
---|---|---|
|
クエリへの応答で返されたユーザーのリスト。 |
配列 |
|
取得したユーザーのID。ユーザーIDは |
文字列 |
|
結果がページ分割されており、ほかにもまだある場合に、ほかの結果を取得するためのトークン。 |
文字列 |
HTTPステータスコード
ステータス | 説明 |
---|---|
| 指定された組織IDのユーザーのリストが正常に取得されました。 |
|
呼び出し元が指定された組織に含まれていません。 |
|
組織IDが無効です。 |
|
ページ分割トークンが無効です。 |
|
認可トークンが無効または期限切れか、リソースに対するアクセス権限が認可トークンにありません。 |
|
操作を実行する権限が呼び出し元にありません。 |
|
ユーザーが、許可されたレート制限(単位時間あたりの指定されたリクエスト数)を超過しています。 |
|
サーバーでエラーが発生しました。 |
|
サーバーがメンテナンスのために停止しているか、過負荷状態または受信リクエストを処理できない状態になっています。 |
ユーザーを削除する
指定したユーザーを削除します。
この操作は以下の国で使用できます。
Healthcare | Hospitality | Senior Living | Core |
---|---|---|---|
なし |
米国、カナダ |
米国、カナダ |
米国、カナダ |
リクエスト
ユーザーを削除するには、/v1/auth/users/{userId}
リソースに対してDELETE
リクエストを実行します。
リクエストヘッダーの例
DELETE /v1/auth/users/{userId} HTTP/1.1
Host: api.amazonalexa.com
Content-Type: application/json
Authorization: Bearer {access token}
リクエストヘッダーのパラメーター
パラメーター | 説明 | 型 | 必須 |
---|---|---|---|
|
文字列 |
◯ | |
|
削除するユーザーのID。ユーザーIDは |
文字列 |
◯ |
リクエスト本文の例
リクエストの本文はありません。
応答
正常に完了すると、HTTP 204が返されます。
応答本文の例
応答の本文はありません。
HTTPステータスコード
ステータス | 説明 |
---|---|
|
ユーザーが正常に削除されました。 |
|
呼び出し元が指定された組織に含まれていません。 |
|
認可トークンが無効または期限切れか、リソースに対するアクセス権限が認可トークンにありません。 |
|
操作を実行する権限が呼び出し元にありません。 |
|
ユーザーが見つかりません。 |
|
ユーザーが、許可されたレート制限(単位時間あたりの指定されたリクエスト数)を超過しています。 |
|
サーバーでエラーが発生しました。 |
|
サーバーがメンテナンスのために停止しているか、過負荷状態または受信リクエストを処理できない状態になっています。 |
関連トピック
最終更新日: 2024 年 03 月 21 日