エンドポイントAPI


エンドポイントAPI

エンドポイントは、Alexaユーザーが操作できるAlexaコネクテッドデバイス(Echoデバイスなど)を表します。Alexa Smart Propertiesでは、Alexa Smart PropertiesエンドポイントAPIを使用して、Echoデバイスを管理します。このAPIを使用すると、Amazonビジネスアカウントで所有されているデバイスの列挙、設定の表示と変更、エンドポイントと特定のルームの関連付けを行うことができます。

APIエンドポイント

リクエストヘッダーでは、組織が所在する地域に応じて、Hostを以下のいずれかに設定してください。

エンドポイント

カナダ、米国

https://api.amazonalexa.com

ドイツ、スペイン、フランス、イタリア、英国

https://api.eu.amazonalexa.com

認証

すべてのAPIリクエストにはAuthorizationヘッダーが必要であり、その値にはLogin with Amazon(LWA)から取得したアクセストークンが入ります。

操作

エンドポイントAPIには、以下の操作が用意されています。

操作 HTTPメソッドとURI

すべてのエンドポイントを取得する

GET /v2/endpoints?owner=~caller

1つのエンドポイントを取得する

GET /v2/endpoints/{endpointId}?expand=all

エンドポイントを照会する(詳細検索)

POST /v2/endpointQuery

associatedUnitsを更新する

PUT /v2/endpoints/{endpointId}/associatedUnits

features/connectivityを取得する

GET /v2/endpoints/{endpointId}/features/connectivity

saveWifiConfigurationsを実行する

POST /credentiallocker/v2/saveWifiConfigurations

addOrUpdateWifiConfigurationsを実行する

POST /v2/endpoints/endpointId/features/connectivity/addOrUpdateWifiConfigurations

Wi-Fiのインストールステータスを取得する

GET /v2/endpoints/endpointId/features/connectivity/addOrUpdateWifiConfigurations/submittedOperations/{operationId}

features/colorを取得する

GET /v2/endpoints/{endpointId}/features/color

features/colorを設定する

POST /v2/endpoints/{endpointId}/features/color/setColor

features/brightnessを取得する

GET /v2/endpoints/{endpointId}/features/brightness

features/brightnessを設定する

POST /v2/endpoints/{endpointId}/features/brightness/setBrightness

features/colorTemperatureを取得する

GET /v2/endpoints/{endpointId}/features/colorTemperature

features/colorTemperatureを設定する

POST /v2/endpoints/{endpointId}/features/colorTemperature/setColorTemperature

features/powerを取得する

GET /v2/endpoints/{endpointId}/features/power

features/powerを設定する

POST /v2/endpoints/{endpointId}/features/power/turnOn
POST /v2/endpoints/{endpointId}/features/power/turnOff

features/temperatureSensorを取得する

GET /v2/endpoints/{endpointId}/features/temperatureSensor

features/thermostatを取得する

GET /v2/endpoints/{endpointId}/features/thermostat

features/speakerを取得する

GET /endpoints/{endpointID}/features/speaker

features/speakerを設定する

POST /v2/endpoints/{endpointId}/features/speaker/setVolume
POST /v2/endpoints/{endpointId}/features/speaker/adjustVolume

エンドポイントの設定値を照会する

GET /v2/endpoints/{endpointId}/settings/{settingName}

エンドポイントの単一の設定を照会する

GET /v2/endpoints/{endpointId}/settings/{settingName}

エンドポイントの複数の設定を照会する

GET /v2/endpoints/{endpointId}/settings?keys={settingNames}&nextToken={nextToken}&maxResults={maxResults}

addressの設定を取得する

GET /v2/endpoints/{endpointId}/settings/address

DoNotDisturbの設定を取得する

GET /v2/endpoints/{endpointId}/settings/Alexa.DoNotDisturb.doNotDisturb

localesの設定を取得する

GET /v2/endpoints/{endpointId}/settings/System.locales

WakeWordsの設定を取得する

GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWords

wakeWordConfirmationの設定を取得する

GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWordConfirmation

SpeechConfirmationの設定を取得する

GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.speechConfirmation

errorSuppressionの設定を取得する

GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.errorSuppression

setupModePrivilegesの設定を取得する

GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.setupModePrivileges

maximumVolumeLimitの設定を取得する

GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.maximumVolumeLimit

timeZoneの設定を取得する

GET /v2/endpoints/{endpointId}/settings/System.timeZone

temperatureUnitの設定を取得する

GET /v2/endpoints/{endpointId}/settings/System.temperatureUnit

distanceUnitsの設定を取得する

GET /v2/endpoints/{endpointId}/settings/System.distanceUnits

AlexaCaptionsの設定を取得する

GET /v2/endpoints/{endpointId}/settings/Accessibility.Captions.AlexaCaptions.enablement

ClosedCaptionsの設定を取得する

GET /v2/endpoints/{endpointId}/settings/Accessibility.Captions.ClosedCaptions.enablement

Magnifierの設定を取得する

GET /v2/endpoints/{endpointId}/settings/Accessibility.Display.Magnifier.enablement

ColorInversionの設定を取得する

GET /v2/endpoints/{endpointId}/settings/Accessibility.Display.ColorInversion.enablement

複数の設定を取得する

GET /v2/endpoints/{endpointId}/settings?keys={settingNames}&nextToken={nextToken}&maxResults={maxResults}

FollowUpの設定を取得する

GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.FollowUp.mode

speakingRateの設定を取得する

GET /v2/endpoints/{endpointId}/settings/SpeechSynthesizer.speakingRate

エンドポイントの設定値を更新する

PUT /v2/endpoints/{endpointId}/settings/{settingName}

addressの設定を更新する

POST /v2/endpoints/{endpointId}/settings/address

DoNotDisturbの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/Alexa.DoNotDisturb.doNotDisturb

localesの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/System.locales

wakeWordsの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWords

wakeWordConfirmationの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWordConfirmation

speechConfirmationの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.speechConfirmation

errorSuppressionの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.errorSuppression

setupModePrivilegesの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.setupModePrivileges

maximumVolumeLimitの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.maximumVolumeLimit

timeZoneの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/System.timeZone

temperatureUnitの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/System.temperatureUnit

distanceUnitsの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/System.distanceUnits

AlexaCaptionsの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/Accessibility.Captions.AlexaCaptions.enablement

ClosedCaptionsの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/Accessibility.Captions.ClosedCaptions.enablement

Magnifierの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/Accessibility.Display.Magnifier.enablement

ColorInversionの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/Accessibility.Display.ColorInversion.enablement

FollowUpの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.FollowUp.mode

speakingRateの設定を更新する

PUT /v2/endpoints/{endpointId}/settings/SpeechSynthesizer.speakingRate

エンドポイントの登録を解除する

POST /v2/endpoints/{endpointId}/deregister

エンドポイントのフレンドリー名を変更する

POST /v2/endpoints/{endpointId}/friendlyName

エンドポイントの情報を削除する

POST /v2/endpoints/{endpointId}/forget

エンドポイントのすべてのタイマーを削除する

POST /v1/alerts/timers?endpoint={endpointId}

エンドポイントを取得する

以下の操作では、エンドポイントに関する情報を取得できます。

すべてのエンドポイントを取得する

Amazonビジネスアカウントに登録したエンドポイントのリストを取得します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエスト

Amazonビジネスアカウントに登録されているエンドポイントのリストを取得するには、GET /v2/endpoints?owner=~callerを呼び出します。

リクエストの形式の例
ユニットに関連付けられていないエンドポイントをすべて取得する

以下の例では、ユニットに関連付けられていない呼び出し元に所有されているエンドポイントのリストを取得します。デフォルトでは、結果は展開されません。

この呼び出しでは、どのユニットにも関連付けられていないエンドポイントだけが返されます。特定のユニットに関連付けられているすべてのエンドポイントを取得するには、ユニットに関連付けられているすべてのエンドポイントを取得するを参照してください。

GET /v2/endpoints?owner=~caller HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

各エンドポイントの詳細を含める

各エンドポイントの詳細を含めるには、以下の例のようにexpand=allパラメーターを使用します。

GET /v2/endpoints?owner=~caller&expand=all HTTP/1.1

各エンドポイントのconnectivityを含める

各エンドポイントのconnectivityの詳細を含めるには、以下のようにexpand=feature:connectivityパラメーターを使用します。

GET /v2/endpoints?owner=~caller&expand=all&expand=feature:connectivity

ユニットに関連付けられているすべてのエンドポイントを取得する

呼び出し元にアクセス権限のある特定のunitIdに関連付けられたすべてのエンドポイントを取得するには、associatedUnits.id={unitId}パラメーターを指定します。

GET /v2/endpoints?associatedUnits.id={unitId}&expand=all

リクエストのクエリパラメーター

フィールド 説明 必須
owner エンドポイントをフィルタリングして、呼び出し元が所有するエンドポイントだけを取得します。現時点でサポートされる値は、"~caller"のみです。これは、ベアラートークンに含まれているユーザー情報を表します。
注:ownerフィルターかassociatedUnits.idフィルターのどちらかを指定する必要があります。
文字列 ◯(associatedUnitsまたはserialNumber.value.textフィルターが指定されていない場合)
associatedUnits.id エンドポイントをフィルタリングして、特定のユニットに関連付けられているエンドポイントだけを取得します。 文字列 ◯(ownerまたはserialNumber.value.textフィルターパラメーターが指定されていない場合)
nextToken 結果の次のページを取得するためのトークン。詳細については、クエリ結果のページ分割を処理するを参照してください。 文字列
maxResults 表示する結果の最大数。値は1~50の間で指定します。デフォルトは10です。 Integer
expand 応答に含めるアトリビュート(またはアトリビュートのセット)。現在サポートされている値は、allfeature:brightnessfeature:colorfeature:colorTemperaturefeature:speakerfeature:temperatureSensorfeature:thermostatfeature:powerfeature:connectivityです。
注: expandでは複数の値を指定できます(例:expand=all&expand=feature.connectivity)。
文字列
manufacturer.value.text エンドポイントをフィルタリングして、manufacturer.value.textが指定値のテキスト全体と完全に一致するエンドポイントだけを取得します。
注: このフィールドでフィルタリングするには、このフィールドを応答に含める必要があります(例:expand=All)。
文字列
model.value.text エンドポイントをフィルタリングして、model.value.textが指定値のテキスト全体と完全に一致するエンドポイントだけを取得します。 文字列
注: このフィールドでフィルタリングするには、このフィールドを応答に含める必要があります(例:expand=All)。
serialNumber.value.text エンドポイントをフィルタリングして、serialNumber.value.textが指定値のテキスト全体と完全に一致するエンドポイントだけを取得します。
注: このフィールドでフィルタリングするには、このフィールドを応答に含める必要があります(例:expand=All)。
文字列 ◯(ownerまたはassociatedUnitsフィルターパラメーターが指定されていない場合)
friendlyName.value.text エンドポイントをフィルタリングして、friendlyName.value.textが指定値のテキスト全体と完全に一致するエンドポイントだけを取得します。
注: このフィールドでフィルタリングするには、このフィールドを応答に含める必要があります(例:expand=All)。
文字列
connections.macAddress エンドポイントをフィルタリングして、macAddressが指定値と完全に一致するエンドポイントだけを取得します。
注: このフィールドでフィルタリングするには、このフィールドを応答に含める必要があります(例:expand=All)。
文字列
features[name:connectivity].properties[name:reachability].value.value エンドポイントをフィルタリングして、reachabilityの値が指定値と完全に一致するエンドポイントだけを取得します。
注: これには、expandにfeatureが指定されている必要があります(例:expand=feature:connectivity)。API呼び出しでこのフィルターを使用する方法の例については、後に示すリクエストの例を参照してください。
文字列
displayCategories.primary.value エンドポイントをフィルタリングして、プライマリー表示カテゴリーが指定値と一致するエンドポイントだけを取得します。 文字列
displayCategories.all.value エンドポイントをフィルタリングして、表示カテゴリーが指定値と一致するエンドポイントだけを取得します。 文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文のパラメーター

フィールド 説明 必須
results クエリへの応答で返されたエンドポイントのリスト。
注: このリストの順序は、リクエストに指定されたクエリパラメーターによって異なる場合があります。
リスト
id エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。 文字列
manufacturer エンドポイントの製造元。NameValueオブジェクトとして表します。 オブジェクト
model エンドポイントのモデル。NameValueオブジェクトとして表します。 オブジェクト
serialNumber エンドポイントのシリアル番号。NameValueオブジェクトとして表します。 オブジェクト
friendlyName エンドポイントのフレンドリー名。NameValueオブジェクトとして表します。 オブジェクト
softwareVersion エンドポイントのソフトウェアバージョン。NameValueオブジェクトとして表します。 オブジェクト
connections エンドポイントがインターネットやスマートホームハブに接続するために使用できる方法。Connectionオブジェクトのリストとして表します。エンドポイントに関連付けられた接続がない場合、このフィールドは空になります。 リスト
creationTime エンドポイントリソースが初めて作成された日時。 ISO 8601形式の日付
features このエンドポイントのFeatureオブジェクトのリスト。 リスト
associatedUnits エンドポイントが関連付けられているユニットを表すUnitオブジェクトのリスト。リクエストにexpand=allが指定された場合にのみ返されます。エンドポイントがどのユニットにも関連付けられていない場合、このリストは空になります。 リスト
operations サポートされている操作を表すOperationのリスト。 リスト
displayCategories Display Categoriesオブジェクト。    
paginationContext Pagination Contextオブジェクト。これがある場合、応答に含まれている結果は不完全です。ない場合は、すべての結果が既に返されています。 オブジェクト

NameValueオブジェクト

フィールド 説明
type 名前の値のタイプ。現時点でサポートされる値は、"PLAIN"のみです。これは、valueプロパティにこのプロパティのプレーンテキスト値が格納されていることを示します。 文字列
value 名前の値。Valueオブジェクトとして指定します。 オブジェクト

"model": {
    "type": "PLAIN",
    "value": {
        "text":"Amazon Echo"
    }

Valueオブジェクト

フィールド 説明
text 文字列値。 文字列

Connectionオブジェクト

フィールド 説明
type 接続の種類。サポートされている値は、 TCP_IPZIGBEEUNKNOWNです。 文字列
macAddress ネットワークインターフェースコントローラーの一意の識別子。 文字列

{
  "type": "TCP_IP",
  "macAddress": "141AC1534151"
}

Featureオブジェクト

フィールド 説明
type 機能の名前。例:"volume""speaker" 文字列
path この機能の展開された結果を取得するための完全なパス。例:"/v2/endpoints/{endpointID}/features/speaker" 文字列

{
    "name": "speaker",
    "path" : "/v2/endpoints/amzn1.alexa.endpoint.ABC123.../features/speaker"
}

Unitオブジェクト

フィールド 説明
id ユニットID。"amzn1.alexa.unit.did.{id}"形式で指定します。 文字列

{
  "id": "amzn1.alexa.unit.did.AFOVR3XKY2EZPRXZ7HURGMCRN7CQKHO45MBSNTYYB2YHD3L7I2C32SI2OLKYZJUQL"
}

Display Categoriesオブジェクト

フィールド 説明
primary エンドポイントのプライマリーカテゴリー。 Display Categoryオブジェクト
all エンドポイントのすべてのカテゴリー。 配列

"displayCategories": {
   "primary": {
      "value": "ALEXA_VOICE_ENABLED",
      "sources": [
         "ENDPOINT_REPORTER"
      ]
   },
   "all": [
      {
         "value": "ALEXA_VOICE_ENABLED",
         "sources": [
            "ENDPOINT_REPORTER"
         ]
      }
   ]
}

Display Categoryオブジェクト

フィールド 説明
value 文字列形式のカテゴリー。 文字列
sources この表示カテゴリーのソース。「CUSTOMER」は、ユーザーが明示的にこの値を設定したことを示します。「ENDPOINT_REPORTER」は、元のエンドポイントレポートの中でこの値が報告されたことを示します。 配列

{
  "value": "LIGHT",
  "sources": ["CUSTOMER", "ENDPOINT_REPORTER"]
}

Pagination Contextオブジェクト

フィールド 説明
nextToken nextTokenの値を次回のリクエストで継続トークン(nextTokenクエリパラメーター)に指定すると、結果の次のページを取得できます。詳細については、クエリ結果のページ分割を処理するを参照してください。 文字列

{
  "nextToken": "ABCD123"
}

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。エラーメッセージの表示はデバッグやログ記録のみを目的としたものであり、ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
400 Bad Request リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden アクセストークンは有効ですが、必要なLWAスコープの権限をユーザーが持っていません。
429 Too many requests リクエストが制限されました。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は429以外の応答を受信するまで256秒ごとに再試行します。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は500以外の応答を受信するまで256秒ごとに再試行します。
503 Service Unavailable サービスが一時的に使用できません。

1つのエンドポイントを取得する

1つのエンドポイントを取得し、呼び出し元にアクセス権限のあるすべてのエンドポイントアトリビュートの一覧を取得します。

呼び出し元には、エンドポイントへのアクセス権限が必要です。このリクエストには、ownerなどのフィルタリングパラメーターは必要ありません。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエスト

1つのエンドポイントを取得し、呼び出し元にアクセス権限のあるすべてのエンドポイントアトリビュートの一覧を取得するには、GET /v2/endpoints/{endpointId}?expand=allを呼び出します。

リクエストの形式の例

以下の例では、この呼び出しの使用方法を示します。

エンドポイントIDのみを取得する

以下の例では、エンドポイントのエンドポイントIDのみを取得します。

GET /v2/endpoints/{endpointId} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}
{
    "id": "amzn1.alexa.endpoint.A234ajd9..."
}
すべてのアトリビュートの一覧を取得する

以下の例では、エンドポイントのすべてのアトリビュートの一覧を取得します。

GET /v2/endpoints/{endpointId}?expand=all HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

すべてのアトリビュートの一覧とspeaker機能を取得する

以下の例では、エンドポイントのすべてのアトリビュートの一覧とspeaker機能を取得します。

GET /v2/endpoints/{endpointId}?expand=all&expand=feature:speaker HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエストのクエリパラメーター

フィールド 説明 必須
expand 応答に含めるアトリビュート(またはアトリビュートのセット)。現在サポートされている値は、allfeature:brightnessfeature:colorfeature:colorTemperaturefeature:speakerfeature:temperatureSensorfeature:thermostatfeature:powerfeature:connectivityです。
注: expandでは複数の値を指定できます(例:expand=all&expand=feature.connectivity)。
文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文のパラメーター

フィールド 説明 必須
id エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。 文字列
friendlyName エンドポイントのフレンドリー名。NameValueオブジェクトとして表します。 オブジェクト
manufacturer エンドポイントの製造元。NameValueオブジェクトとして表します。 オブジェクト
model エンドポイントのモデル。NameValueオブジェクトとして表します。 オブジェクト
serialNumber エンドポイントのシリアル番号。NameValueオブジェクトとして表します。 オブジェクト
softwareVersion エンドポイントのソフトウェアバージョン。NameValueオブジェクトとして表します。 オブジェクト
connections エンドポイントがインターネットやスマートホームハブに接続するために使用できる方法。Connectionオブジェクトのリストとして表します。エンドポイントに関連付けられた接続がない場合、このフィールドは空になります。 リスト
creationTime エンドポイントリソースが初めて作成された日時。 ISO 8601形式の日付
features このエンドポイントのFeatureオブジェクトのリスト。 リスト
associatedUnits エンドポイントが関連付けられているユニットを表すUnitオブジェクトのリスト。リクエストにexpand=allが指定された場合にのみ返されます。エンドポイントがどのユニットにも関連付けられていない場合、このリストは空になります。 リスト
displayCategories Display Categoriesオブジェクト。    
operations サポートされている操作を表すOperationオブジェクトのリスト。 リスト

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラーのエラータイプ。リクエストは有効だったものの、サービスがリクエストの実行に失敗した場合にのみ存在します。このフィールドはビジネスロジックで使用できます。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード 名前 説明
200 Success リクエストが成功しました。
400 Bad Request リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized 認証に失敗しました。
404 Not Found パスにエンドポイントが存在しないか、エンドポイントIDが無効です。
429 Too Many Requests リクエストが制限されました。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は429以外の応答を受信するまで256秒ごとに再試行します。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は500以外の応答を受信するまで256秒ごとに再試行します。
503 Service Unavailable サービスが一時的に使用できません。

エンドポイントを照会する(詳細検索)

指定した条件を満たすエンドポイントのリストを取得するには、POST /v2/endpointQueryを呼び出します。この操作では、ユニット、製造元、モデルによる照会がサポートされます。

クエリは複数のAND句またはOR句を使用して作成できます。たとえば、「(ユニットID=amzn1.alexa.unit.unitOne OR amzn1.alexa.unit.unitTwo)AND 製造元名=someManufacturer」という条件を満たすエンドポイントを検索できます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエスト

エンドポイントを照会するには、/v2/endpointQueryリソースにPOSTリクエストを行います。

リクエストヘッダーの例

クリップボードにコピーされました。

POST /v2/endpointQuery HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {access token}
リクエストパスとリクエストヘッダーのパラメーター
パラメーター 位置 説明 必須

access token

ヘッダー

LWAトークン

文字列

リクエスト本文の例

以下のリクエストは、2つのユニットでエンドポイントを照会します。

クリップボードにコピーされました。

{
  "query": {
    "or": [
      {
        "match": {
          "associatedUnits.id": "amzn1.alexa.unit.did.unitOne"
        }
      },
      {
        "match": {
          "associatedUnits.id": "amzn1.alexa.unit.did.unitTwo"
        }
      }
    ]
  },
  "paginationContext": {
    "maxResults": 50,
    "nextToken": "WncIu8IrscO..."
  },
  "expand": [
    "all", "feature:connectivity"
  ]
}

以下のリクエストは、デバイスの製造元によってフィルタリングされた2つのユニットでエンドポイントを照会します。

クリップボードにコピーされました。

{
  "query": {
    "and": [
      {
        "or": [
          {
            "match": {
               "associatedUnits.id": "amzn1.alexa.unit.did.unitOne"
            }
          },
          {
            "match": {
               "associatedUnits.id": "amzn1.alexa.unit.did.unitTwo"
            }
          }
        ]
      },
      {
        "match": {
          "manufacturer.value.text": "Amazon"
        }
      }
    ]
  },
  "paginationContext": {
    "maxResults": 50,
    "nextToken": "WncIu8IrscO..."
  },
  "expand": [
    "all", "feature:power"
  ]
}

以下のリクエストは、デバイスの製造元とモデルによってフィルタリングされた2つのユニットでエンドポイントを照会します。

クリップボードにコピーされました。

{
   "query":{
      "and":[
         {
            "or":[
               {
                  "match":{
                     "associatedUnits.id":"amzn1.alexa.unit.did.unitOne"
                  }
               },
               {
                  "match":{
                     "associatedUnits.id":"amzn1.alexa.unit.did.unitTwo"
                  }
               }
            ]
         },
         {
            "match":{
               "manufacturer.value.text":"Amazon"
            }
         },
         {
            "match":{
               "model.value.text":"Echo Dot (3rd generation)"
            }
         }
      ]
   },
   "paginationContext":{
      "maxResults":50,
      "nextToken":"WncIu8IrscO..."
   },
   "expand":[
      "all",
      "feature:power"
   ]
}
リクエスト本文のパラメーター
パラメーター 説明 必須

query

クエリのフィルタリング条件を提供するオブジェクト。フィールドは、andまたはorのいずれかのリストになります。別のand/orフィルタリング条件のリストを入れ子として含めることもできます。

オブジェクト

query.and[]

and論理演算子を使用して2つ以上のパラメーターを論理的に結合するクエリ。

配列

query.and[*].match

特定のクエリフィールドを含むオブジェクト。このクエリフィールドの値は、返されるエンドポイントの対応する値と完全に一致する必要があります。以下のタイプの値を指定できます。

  • associatedUnits.id: フィルタリングの条件となるユニットID。例:amzn1.alexa.unit.did.unitOne

  • manufacturer.value.text: フィルタリングの条件となるAlexa搭載デバイスの製造元。例: Amazon

  • model.value.text: フィルタリングの条件となるAlexa搭載デバイスのモデル。例: Echo Dot (3rd generation)

オブジェクト

query.or[]

or論理演算子を使用して2つ以上のパラメーターを論理的に結合するクエリ。

配列

query.or[*].match

特定のクエリフィールドを含むオブジェクト。このクエリフィールドの値は、返されるエンドポイントの対応する値と完全に一致する必要があります。以下のタイプの値を指定できます。

  • associatedUnits.id: フィルタリングの条件となるユニットID。例:amzn1.alexa.unit.did.unitOne

  • manufacturer.value.text: フィルタリングの条件となるAlexa搭載デバイスの製造元。例: Amazon

  • model.value.text: フィルタリングの条件となるAlexa搭載デバイスのモデル。例: Echo Dot (3rd generation)

オブジェクト

paginationContext

結果のページ分割コンテキスト。

オブジェクト

paginationContext.nextToken

ページ分割された結果から特定のページを取得するためのトークン。このトークンがない場合、応答には結果の先頭ページが含められます。

文字列

paginationContext.maxResults

応答本文で返される結果の最大数。1より大きい10以下の値を指定してください。

数値

expand

指定したグループに基づいて、最上位のアトリビュートでエンドポイントの詳細を取得するために使用する配列。現在、すべてのエンドポイントアトリビュートはallグループに含まれています。expandの値の例は以下のとおりです。
  • feature:speaker
  • feature:connectivity
  • feature:power
  • feature:thermostat

配列

オプション

応答

正常に完了すると、HTTP 200が返されます。

応答本文の例

以下は、expand配列でfeature:connectivityを指定してこの操作を行った場合の結果の例です。

以下は、この操作を使用してassociatedUnits.idのエンドポイントを検索した場合の結果の例です。

応答本文のパラメーター
パラメーター 説明

results

クエリへの応答で返されたエンドポイントのリスト。このリストの順序は、リクエストに指定されたクエリパラメーターによって異なる場合があります。

配列

id

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

friendlyName

エンドポイントのフレンドリー名。NameValueオブジェクトとして表します。

オブジェクト

manufacturer

エンドポイントの製造元。NameValueオブジェクトとして表します。

オブジェクト

model

エンドポイントのモデル。NameValueオブジェクトとして表します。

オブジェクト

serialNumber

エンドポイントのシリアル番号。NameValueオブジェクトとして表します。

オブジェクト

softwareVersion

エンドポイントのソフトウェアバージョン。NameValueオブジェクトとして表します。

オブジェクト

connections

エンドポイントがインターネットやスマートホームハブに接続するために使用できる方法。Connectionオブジェクトのリストとして表します。エンドポイントに関連付けられた接続がない場合、このフィールドは空になります。

配列

creationTime

エンドポイントリソースが初めて作成された日時。

ISO 8601形式の日付

features

このエンドポイントのFeatureオブジェクトのリスト。

配列

associatedUnits

エンドポイントが関連付けられているユニットを表すUnitオブジェクトのリスト。リクエストにexpand=allが指定された場合にのみ返されます。エンドポイントがどのユニットにも関連付けられていない場合、このリストは空になります。

配列

operations

サポートされている操作を表すOperationオブジェクトのリスト。

配列

displayCategories

Display Categoriesオブジェクト。

オブジェクト

paginationContext

Pagination Contextオブジェクト。これがある場合、応答に含まれている結果は不完全です。ない場合は、すべての結果が既に返されています。

オブジェクト

HTTPステータスコード
ステータス 説明

200 OK

リクエストが成功しました。

400 Bad Request

リクエストの形式が正しくないか、必須パラメーターが不足しています。

401 Unauthorized

認可トークンが無効または期限切れか、リソースに対するアクセス権限が認可トークンにありません。

403 Forbidden

リクエストを完了できませんでした。この操作を実行する権限がクライアントにありません。

404 Endpoint not found

リクエストされたエンドポイントが見つかりませんでした。

429 Too Many Requests

ユーザーが、許可されたレート制限(単位時間あたりの指定されたリクエスト数)を超過しています。

500 Internal Server Error

サーバー側のエラーが発生しました。

503 Service Unavailable

サービスが一時的に使用できません。

エンドポイントとユニットの関連付けを管理する

associatedUnitsを更新する

エンドポイントに関連付けられているユニットのリストを更新するには、PUT /v2/endpoints/{endpointId}/associatedUnitsを呼び出します。このAPIは、エンドポイントとユニットの関連付けを解除する場合にも使用します。

以下の重要事項を考慮してください。

  • ユニットの関連付けの変更時には、エンドポイントにアクティブな接続が必要です。このAPIの呼び出しに成功してから1分間は、デバイスの電源を入れてオンラインの状態を維持してください。
  • 現時点では、エンドポイントに関連付けることができるユニットは一度に1つだけです。
  • デバイスをルームに関連付けると、デバイスのフレンドリー名が変更されることがあります。たとえば、「春子のデバイス」が「ゲストのデバイス」に変わることがあります。
  • エンドポイントとルームの関連付けを解除するには、PUT /v2/endpoints/{endpointId}/associatedUnitsを呼び出して、デフォルトのユニットのワイルドカード("~caller.defaultUnitId")を指定します。
  • 設定の適用は、必ずユニットにデバイスが関連付けられた後に行う必要があります。ユニットの関連付けが更新されると、デバイスに適用されていた設定はすべて消去されます。associatedUnitsを更新するAPIを呼び出して、コード200が返されたら、エンドポイントが正常に再起動されていることを確認する必要があります。エンドポイントのステータスを照会するを参照してください。
  • エンドポイントとユニットの関連付けを変更すると、endpointIdが変更されることがあります。応答には、新しいendpointIdが返されます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/associatedUnits HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

[
  {
    "id": "amzn1.alexa.unit.did.{id}"
  }
]

デフォルトのユニットIDのワイルドカードを使用するリクエスト本文

[
  {
    "id": "~caller.defaultUnitId"
  }
]

リクエスト本文のパラメーター

フィールド 説明 必須
Unitオブジェクトのリスト エンドポイントに関連付けられているユニットのリスト。配列の各要素は、"amzn1.alexa.unit.did.{id}"という形式のユニットIDです。呼び出し元のデフォルトのユニットを指定するには、"~caller.defaultUnitId"というワイルドカードを使用します。現時点では、エンドポイントに関連付けることができるユニットは一度に1つだけです。
注: ユニットからエンドポイントを削除して呼び出し元のAmazonビジネスアカウントに返すには、エンドポイントを呼び出し元のデフォルトのユニットに関連付けます。
配列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

{
    "endpoint": {
        "id": "amzn1.alexa.endpoint.ABC123...",
        "associatedUnits": [{
            "id": "amzn1.alexa.unit.did.ZXY987..."
        }]
    }
}

応答本文のパラメーター

フィールド 説明 必須
endpoint.id エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。注: エンドポイントとユニットの関連付けを変更すると、endpointIdが変更されることがあります。変更された場合、このフィールドには新しいendpointIdが格納されます。 文字列
associatedUnits エンドポイントが関連付けられているユニットを表すUnitオブジェクトのリスト。現時点では、エンドポイントに関連付けることができるユニットは一度に1つだけです。 リスト
associatedUnits[].id ユニットID。"amzn1.alexa.unit.did.{id}"形式で指定します。 文字列

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラーのエラータイプ。リクエストは有効だったものの、サービスがリクエストの実行に失敗した場合にのみ存在します。このフィールドはビジネスロジックで使用できます。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 NO_SUCH_UNIT No such unit 本文で指定されたユニットが存在しません。
400 TOO_MANY_UNIT_ASSOCIATIONS The request exceeds the maximum number of unit IDs. リクエストは、ユニットIDの最大数を超過しています。指定するユニットIDの数を減らしてみてください。
400 ENDPOINT_UNREACHABLE The endpoint is unreachable. エンドポイントがオフラインです。デバイスに到達できないため、associatedUnitsを変更できません。
400 ENDPOINT_NOT_SUPPORTED Modifying associatedUnits is not supported for this endpoint. このデバイスタイプでは、associatedUnitsの変更はサポートされていません。
400 TOO_FEW_UNIT_ASSOCIATIONS The request specifies too few unit IDs. 少なくとも1つのユニットIDを指定する必要があります。
401 UNAUTHORIZED Invalid or missing access token LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden クライアントはリソースのリストを取得できますが、リソースの名前を変更する権限がありません。
404 NO_SUCH_ENDPOINT Endpoint not found パスにエンドポイントが存在しないか、クライアントにリソースのリストを取得する権限がありません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。1秒後に再試行し、待機間隔が256秒になるまでエクスポネンシャルバックオフを実行して、それ以降は429以外の応答を受信するまで256秒ごとに再試行してください。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。1秒後に再試行し、待機間隔が256秒になるまでエクスポネンシャルバックオフを実行して、それ以降は500以外の応答を受信するまで256秒ごとに再試行してください。
503 SERVICE_UNAVAILABLE Service Unavailable サービスが一時的に利用不可能なため、リクエストを処理できません。

エンドポイントのステータスを照会する

associatedUnitsを更新するAPIを呼び出して、コード200を受け取ると、クラウド側でエンドポイントとユニットを関連付ける処理が完了します。ただし、エンドポイント側でエンドポイントとユニットの関連付けを完了するには、物理的なエンドポイントで自動再起動が完了する必要があります。エンドポイントは自動的に再起動されるため、特に必要な手順はありません。

エンドポイントが正常に再起動されたかどうかを確認するには、エンドポイントの接続ステータスをポーリングします。ポーリングの間隔は2分以上にすることをお勧めします。

このAPIからendpointIdが返されれば、エンドポイントは正常に再起動され、ネットワークに再接続されています。

リクエストの例

GET /v2/endpoints?associatedUnits.id=amzn1.alexa.unit.did.foo&connections.macAddress=00:11:22:AA:BB:33:44:55&features[name:connectivity].properties[name:reachability].value.value=OK HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

connectivity機能を管理する

features/connectivityを取得する

エンドポイントの接続に関連する状態とアトリビュートを取得するには、GET /v2/endpoints/{endpointId}/features/connectivityを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/connectivity  HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

{
    "properties": [
        {
            "name": "reachability",
            "type": "RETRIEVABLE",
            "value": {
                "value": "OK"
            },
            "timeOfSample": "2020-07-20T00:00:00Z"
        }
    ]
}

応答本文のパラメーター

フィールド 説明 必須
name プロパティの名前。この場合は"reachability"になります。 文字列
value エンドポイントが到達可能な場合は"OK"、そうでない場合は"UNREACHABLE"になります。 文字列
timeOfSample プロパティ値が取得された日時。 日付
error このフィールドが存在する場合は、プロパティ値の取得中にエラーが発生したことを示します。 オブジェクト

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
400 Bad Request リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden アクセストークンは有効ですが、必要なLWAスコープの権限をユーザーが持っていません。
429 Too many requests リクエストが制限されました。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は429以外の応答を受信するまで256秒ごとに再試行します。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は500以外の応答を受信するまで256秒ごとに再試行します。
503 Service Unavailable サービスが一時的に使用できません。

Wi-Fi設定を管理する

AlexaエンドポイントのWi-Fi設定を管理し、ステータスを追跡します。これらのリクエストを使用するには、"credential_locker::wifi_management"および"alexa::enterprise:management"のスコープを持つLWAトークンが必要です。

saveWifiConfigurationsを実行する

後でエンドポイントで使用できるようにWi-Fi設定を保存するには、POST /credentiallocker/v2/saveWifiConfigurationsを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、ドイツ、スペイン、フランス、イタリア、英国

米国、カナダ、ドイツ、スペイン、フランス、イタリア、英国

米国

リクエストの形式

POST /credentiallocker/v2/saveWifiConfigurations HTTP/1.1
Host: credential-locker-service.amazon.com
x-amz-access-token: {LWA Token}
Content-Type: application/json
Authorization: Bearer {LWA Token}

リクエスト本文の形式

以下は、WPAPSKのリクエスト本文の例です。

{
  "wifiConfigurations": [
    {
      "credentialConfiguration": {
        "privateSharedKey": "\"wifi-password\""
      },
      "ssid": "\"wifi-ssid\"",
      "keyManagement": "WPAPSK"
    }
  ]
}

以下は、WPA2_EAPのリクエスト本文の例です。

{
  "wifiConfigurations": [
    {
      "credentialConfiguration": {
        "eapAuthenticationMethod": "EAP_TLS",
        "certificateAuthority": {
          "providerName": "ALEXA_ENTERPRISE",
          "id": "amzn1.alexa.enterprise.certificateAuthority.did.EXAMPLE_ID_VALUE"
        },
        "authenticationServerCertificates": [
          "-----BEGIN CERTIFICATE-----\nCERTIFICATE_CONTENT\nMULTIPLE_LINES_WITH_LINE_BREAK_CHARACTERS\n-----END CERTIFICATE-----",
          "-----BEGIN CERTIFICATE-----\nCERTIFICATE_CONTENT\nMULTIPLE_LINES_WITH_LINE_BREAK_CHARACTERS\n-----END CERTIFICATE-----"
        ]
      },
      "ssid": "\"wifi-ssid\"",
      "keyManagement": "WPA2_EAP"
    }
  ]
}

リクエスト本文のパラメーター

フィールド 説明 必須

credentialConfiguration.privateSharedKey

プライベート共有キー。二重引用符で囲む必要があります。

文字列

credentialConfiguration.eapAuthenticationMethod

使用されるEAPメソッドを識別します。現在、サポートされているのはEAP-TLSのみです。

文字列

credentialConfiguration.certificateAuthority

プロバイダーとリソースのIDによって認証局を識別します。

オブジェクト

credentialConfiguration.certificateAuthority.providerName

証明書発行者のプロバイダーを識別します

文字列

credentialConfiguration.certificateAuthority.id

プロバイダーのシステム内の認証局リソースのIDを識別します。

文字列

credentialConfiguration.authenticationServerCertificates

WPA2-EnterpriseネットワークのIDの検証に使用する認証サーバーによって提供される証明書のリスト。

リスト

ssid

Wi-Fi設定のネットワーク名。二重引用符で囲む必要があります。

文字列

keyManagement

Wi-Fi設定のセキュリティタイプ。
有効な値:

  • NONE(オープンネットワークの場合)
  • WPAPSK(パスワードベースのWi-Fi SSIDの場合)
  • WPA2_EAP(WPA2エンタープライズWi-Fiの場合)

文字列

HTTP応答コード

ステータスコード タイプの説明  
200 OK Wi-Fi設定が正常に保存されました。
400 BAD_REQUEST リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 UNAUTHORIZED LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN 操作を実行する権限がユーザーにありません。
500 INTERNAL_SERVER_ERROR サービスエラーが発生しました。

addOrUpdateWifiConfigurationsを実行する

保存したWi-Fi設定をエンドポイントに関連付けるには、POST /v2/endpoints/endpointId/features/connectivity/addOrUpdateWifiConfigurationsを呼び出します。エンドポイントごとに、最大32個のWi-Fi設定を関連付けることができます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、スペイン

米国、カナダ、スペイン

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/features/connectivity/addOrUpdateWifiConfigurations HTTP/1.1
Host: api.amazonalexa.com
Authorization: Bearer {LWA Token}
Content-Type: application/json

リクエストのパスパラメーター

フィールド 説明 必須
endpointId すべてのエンドポイントを取得する呼び出しで返されるエンドポイントID。 文字列

リクエスト本文の形式

{
    "payload": {
        "wifiConfigurations": [{
            "ssid": "\"wifi-ssid\"",
            "keyManagement": "WPAPSK"
        }]
    }
}

リクエスト本文のパラメーター

フィールド 説明 必須

ssid

Wi-Fi設定のネットワーク名。二重引用符で囲む必要があります。saveWifiConfigurationsを実行する呼び出しと同じ値を使用する必要があります。

文字列

keyManagement

Wi-Fi設定のセキュリティタイプ。saveWifiConfigurationsを実行する呼び出しと同じ値を使用する必要があります。
有効な値:

  • NONE(オープンネットワークの場合)
  • WPAPSK(パスワードベースのWi-Fi SSIDの場合)
  • WPA2_EAP(WPA2エンタープライズWi-Fiの場合)

文字列

応答本文の形式

{
     "submittedOperationId": "{operationId}"
}

応答本文のパラメーター

フィールド 説明 必須
submittedOperationId 操作のステータスを取得するために使用する識別子。 文字列

HTTP応答コード

ステータスコード タイプの説明  
202 OK Wi-Fiのインストール操作が正常に開始され、ステータスを追跡するためのoperationIdが応答本文に返されました。
400 BAD_REQUEST リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 UNAUTHORIZED LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN 操作を実行する権限がユーザーにありません。
404 NOT_FOUND デバイスエンドポイントが見つからなかったか、指定されたWi-Fi設定が見つかりませんでした。
500 INTERNAL_SERVER_ERROR サービスエラーが発生しました。

Wi-Fiのインストールステータスを取得する

addOrUpdateWifiConfigurations操作のステータスを取得するには、GET /v2/endpoints/endpointId/features/connectivity/addOrUpdateWifiConfigurations/submittedOperations/{operationId}を呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、スペイン

米国、カナダ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/connectivity/addOrUpdateWifiConfigurations/submittedOperations/{operationId} HTTP/1.1
Host: api.amazonalexa.com
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須
endpointId エンドポイントID。POST addOrUpdateWiFiConfigurationsの呼び出しで使用したものと同じIDを使用する必要があります。 文字列
operationId 操作ID。POST addOrUpdateWifiConfigurationsの呼び出しで返されたsubmittedOperationIdの値を使用する必要があります。 文字列

応答本文の例

{
     "status": "TIMEOUT"
}

応答本文のパラメーター

フィールド 説明 必須
status 指定されたaddOrUpdateWifiConfigurations操作の状態。Statusオブジェクトとして表します。 オブジェクト

Statusオブジェクトのスキーマ

フィールド 説明 必須

status

ステータスの値。有効な値は以下のとおりです。
SUCCESS: Wi-Fi設定はデバイスに正常にインストールされています。これは、指定されたWi-Fi設定に対するデバイスの接続ステータスの情報を示すものではありません。
FAILURE: デバイスへのメッセージの配信中、またはデバイスでのインストール中にエラーが発生しました。詳細な内部エラーは提供されません。操作を再試行してください。
TIMEOUT: 操作がタイムアウトしました。デバイスがオフラインになっているか、応答を返せませんでした。実際のインストールステータスは不明です。操作を再試行してください。
IN_PROGRESS: 操作はまだ進行中です。

文字列

HTTP応答コード

ステータスコード タイプの説明  
200 OK 操作により、ステータスの値が正常に返されました。
300 RESOURCE_SPLIT エンドポイントIDが変更されましたが、基になるリソースは変わりません。応答本文には、新しいエンドポイントIDのURI参照が含まれます。たとえば、/v2/endpoints/{newId}のようになります。
301 ENDPOINT_REMOVED エンドポイントIDが変更されましたが、基になるリソースは変わりません。応答本文には、新しいエンドポイントIDのURI参照が含まれます。たとえば、/v2/endpoints/{newId}のようになります。
303 ENDPOINT_MERGED エンドポイントが別のエンドポイントと結合されたため、基になるリソースが変更されました。応答本文には、新しいエンドポイントIDのURI参照が含まれます。たとえば、/v2/endpoints/{newId}のようになります。
400 BAD_REQUEST リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 UNAUTHORIZED LWAトークンの有効期限が切れています。
403 FORBIDDEN 指定されたエンドポイントに対して操作を実行する権限がユーザーにありません。
404 NOT_FOUND 指定されたendpointIdまたはaddOrUpdateWifiConfigurationsリクエストが存在しないか、リクエストのステータスが使用できなくなっています。
500 INTERNAL_SERVER_ERROR サービスエラーが発生しました。
503 Service Unavailable サービスが一時的に使用できません。

スマートホーム機能を管理する

features/colorを取得する

指定したエンドポイントの色のプロパティと、使用可能な操作を取得するには、GET /v2/endpoints/{endpointId}/features/colorを呼び出します。色のプロパティの詳細については、機能のプロパティのスキーマを参照してください。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/color HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

成功応答のヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

{
   "properties": [
      {
         "name": "color",
         "type": "RETRIEVABLE",
         "value": {
            "hue": 20,
            "saturation": 0.5,
            "brightness": 0.7
         },
         "timeOfSample": "1970-01-01T00:00:00Z"
      }
   ],
   "operations": [
      {
         "name": "setColor",
         "path": "/v2/endpoints/{id}/features/color/setColor"
      }
   ]
}

部分的な成功応答本文の例

以下は、colorプロパティの取得中にエラーが発生した場合に返される応答の例です。

{
    "properties": [
        {
            "name": "color",
            "type": "ERROR",
            "error": {
                "type": "",
                "message": ""
            }
        }
    ],
    "operations": [
        {
            "name": "setColor",
            "path": "/v2/endpoints/{id}/features/color/setColor"
        }
    ]
}

応答本文のパラメーター

フィールド 説明 必須
properties 色のプロパティのリスト。現在、サポートされているのはcolorのみです。各Propertyオブジェクトはポリモーフィズム型です。リストの内容は、クライアントにデータを表示する権限があるかどうかによって異なります。 Propertyオブジェクトのリスト ◯(ただし、空の場合もあります)
operations 指定されたエンドポイントで使用可能な色の操作を定義するオブジェクトのリスト。 Operationオブジェクトのリスト

Propertyオブジェクトのスキーマ

フィールド 説明 必須
name 設定するプロパティの名前。現時点でサポートされる値は、"color"のみです。 文字列
type Propertyオブジェクトのタイプ。以下の3つの値がサポートされています。
RETRIEVABLE - Alexaでプロパティの値を取得できます。
NOT_RETRIEVABLE - プロパティで取得がサポートされていません。再試行しても成功しません。
ERROR - エラーにより、Alexaでプロパティの値を取得することができません。再試行すると成功する場合があります。
文字列
value 現在の色。詳細については、機能のプロパティのスキーマを参照してください。 文字列
timeOfSample プロパティ値が取得された日時。 日付
error このフィールドが存在する場合は、プロパティ値の取得中にエラーが発生したことを示します。 オブジェクト

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

Errorオブジェクトのスキーマ

フィールド 説明 必須
type プロパティの取得中に発生したエラーのタイプ。例:ENDPOINT_UNREACHABLEENDPOINT_BUSY。有効なエラータイプについては、エラータイプの値を参照してください。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

features/colorを設定する

指定したエンドポイントの色のプロパティを設定するには、POST /v2/endpoints/{endpointId}/features/color/setColorを呼び出します。色のプロパティの詳細については、機能のプロパティのスキーマを参照してください。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/features/color/{operation} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須
endpointId エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。 文字列
operation 実行する操作。setColorを指定します。 文字列

setColorのリクエスト本文の例

{
    "payload": {
        "color": {
            "hue": 20,
            "saturation": 0.75,
            "brightness": 0.34
        }
    }
}

setColorのリクエスト本文のパラメーター

フィールド 説明 必須

payload

ペイロードのラッパーオブジェクト。

オブジェクト

payload.color

Colorオブジェクト。詳細については、機能のプロパティのスキーマを参照してください。

オブジェクト

payload.color.hue

色相の値。

倍精度

payload.color.saturation

彩度の値。

倍精度

payload.color.brightness

輝度の値。

倍精度

成功応答のヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

成功応答本文

操作が完全に成功した場合、応答本文はありません。

部分的な成功応答の例

HTTP/1.1 503 Service Unavailableの応答は、リクエストは正常に送信されたものの、Alexaがエンドポイントレポーターからエラー応答を受け取ったことを示します。エンドポイントのエラーの例として、エンドポイントがオフラインになっている、エンドポイントのバッテリー残量が少なすぎるなどがあります。

HTTP/1.1 503 Service Unavailable
{
    "type": "",
    "message": ""
}

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

Errorオブジェクトのスキーマ

フィールド 説明 必須
type 発生したエラーのタイプ。例:ENDPOINT_UNREACHABLEENDPOINT_BUSY。リクエストは有効だったものの、リクエストを正常に実行できなかった場合にのみ存在します。有効なエラータイプについては、エラータイプの値を参照してください。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

features/brightnessを取得する

指定したエンドポイントの輝度の設定と使用可能な操作を取得するには、GET /v2/endpoints/{endpointId}/features/brightnessを呼び出します。輝度のプロパティの詳細については、機能のプロパティのスキーマを参照してください。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/brightness HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

成功応答のヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

{
   "properties": [
      {
         "name": "brightness",
         "type": "RETRIEVABLE",
         "value": {
            "value": 50
         },
         "timeOfSample": "1970-01-01T00:00:00Z"
      }
   ],
   "operations": [
       {
          "name": "setBrightness",
          "path": "/v2/endpoints/{id}/features/brightness/setBrightness"
       },
       {
          "name": "adjustBrightness",
          "path": "/v2/endpoints/{id}/features/brightness/adjustBrightness"
       }
   ]
}

部分的な成功応答本文の例

以下は、brightnessプロパティの取得中にエラーが発生した場合に返される応答の例です。

{
    "properties": [
        {
            "name": "brightness",
            "type": "ERROR",
            "error": {
                "type": "",
                "message": ""
            }
        }
    ],
    "operations": [
        {
            "name": "setBrightness",
            "path": "/v2/endpoints/{id}/features/brightness/setBrightness"
        },
        {
            "name": "adjustBrightness",
            "path": "/v2/endpoints/{id}/features/brightness/adjustBrightness"
        }
    ]
}

応答本文のパラメーター

フィールド 説明 必須
properties 輝度のプロパティのリスト。現在、サポートされているのはbrightnessのみです。各Propertyオブジェクトはポリモーフィズム型です。リストの内容は、クライアントにデータを表示する権限があるかどうかによって異なります。 Propertyオブジェクトのリスト ◯(ただし、空の場合もあります)
operations 指定されたエンドポイントで使用可能な輝度の操作を定義するオブジェクトのリスト。 Operationオブジェクトのリスト

Propertyオブジェクトのスキーマ

フィールド 説明 必須
name 設定するプロパティの名前。現時点でサポートされる値は、"brightness"のみです。 文字列
type Propertyオブジェクトのタイプ。以下の3つの値がサポートされています。
RETRIEVABLE - Alexaでプロパティの値を取得できます。
NOT_RETRIEVABLE - プロパティで取得がサポートされていません。再試行しても成功しません。
ERROR - エラーにより、Alexaでプロパティの値を取得することができません。再試行すると成功する場合があります。
文字列
value 現在の輝度のレベル。有効な値は0~100です(両端の値を含みます)。詳細については、機能のプロパティのスキーマを参照してください。 文字列
timeOfSample プロパティ値が取得された日時。 日付
error このフィールドが存在する場合は、プロパティ値の取得中にエラーが発生したことを示します。 オブジェクト

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

Errorオブジェクトのスキーマ

フィールド 説明 必須
type プロパティの取得中に発生したエラーのタイプ。例:ENDPOINT_UNREACHABLEENDPOINT_BUSY。有効なエラータイプについては、エラータイプの値を参照してください。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

features/brightnessを設定する

指定したエンドポイントの輝度のレベルを設定するには、POST /v2/endpoints/{endpointId}/features/brightness/setBrightnessを呼び出します。指定したエンドポイントの輝度のレベルを指定した量だけ変更するには、POST /v2/endpoints/{endpointId}/features/brightness/adjustBrightnessを呼び出します。

輝度のプロパティの詳細については、機能のプロパティのスキーマを参照してください。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/features/brightness/{operation} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須
endpointId エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。 文字列
operation 実行する操作。setBrightnessを指定します。 文字列

setBrightnessのリクエスト本文の例

{
    "payload": {
        "brightness": 50
    }
}

setBrightnessのリクエスト本文のパラメーター

フィールド 説明 必須

payload

ペイロードのラッパーオブジェクト。

オブジェクト

payload.brightness

輝度の値。有効な値は0~100です(両端の値を含みます)。詳細については、機能のプロパティのスキーマを参照してください。

整数

adjustBrightnessのリクエスト本文の例

{
    "payload": {
        "brightnessDelta": 10
    }
}

adjustBrightnessのリクエスト本文のパラメーター

フィールド 説明 必須

payload

ペイロードのラッパーオブジェクト。

オブジェクト

payload.brightnessDelta

輝度の差分の値。有効な値は-100~100です(両端の値を含みます)。詳細については、機能のプロパティのスキーマを参照してください。

整数

成功応答のヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

成功応答本文

操作が完全に成功した場合、応答本文はありません。

部分的な成功応答の例

HTTP/1.1 503 Service Unavailableの応答は、リクエストは正常に送信されたものの、Alexaがエンドポイントレポーターからエラー応答を受け取ったことを示します。エンドポイントのエラーの例として、エンドポイントがオフラインになっている、エンドポイントのバッテリー残量が少なすぎるなどがあります。

HTTP/1.1 503 Service Unavailable
{
    "type": "",
    "message": ""
}

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

Errorオブジェクトのスキーマ

フィールド 説明 必須
type 発生したエラーのタイプ。例:ENDPOINT_UNREACHABLEENDPOINT_BUSY。リクエストは有効だったものの、リクエストを正常に実行できなかった場合にのみ存在します。有効なエラータイプについては、エラータイプの値を参照してください。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

features/colorTemperatureを取得する

指定したエンドポイントの色温度のプロパティと、使用可能な操作を取得するには、GET /v2/endpoints/{endpointId}/features/colorTemperatureを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/colorTemperature HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

成功応答のヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

{
   "properties": [
      {
         "name": "colorTemperatureInKelvin",
         "type": "RETRIEVABLE",
         "value": {
            "value": "2700"
         },
         "timeOfSample": "1970-01-01T00:00:00Z"
      }
   ],
   "operations": [
      {
          "name": "setColorTemperature",
          "path": "/v2/endpoints/{id}/features/colorTemperature/setColorTemperature"
      },
      {
         "name": "increaseColorTemperature",
         "path": "/v2/endpoints/{id}/features/colorTemperature/increaseColorTemperature"
      },
      {
         "name": "decreaseColorTemperature",
         "path": "/v2/endpoints/{id}/features/colorTemperature/decreaseColorTemperature"
      }
   ]
}

部分的な成功応答本文の例

以下は、colorTemperatureプロパティの取得中にエラーが発生した場合に返される応答の例です。

{
    "properties": [
        {
            "name": "colorTemperatureInKelvin",
            "type": "ERROR",
            "error": {
                "type": "",
                "message": ""
            }
        }
    ],
    "operations": [
        {
            "name": "setColorTemperature",
            "path": "/v2/endpoints/{id}/features/colorTemperature/setColorTemperature"
        },
        {
           "name": "increaseColorTemperature",
           "path": "/v2/endpoints/{id}/features/colorTemperature/increaseColorTemperature"
        },
        {
          "name": "decreaseColorTemperature",
          "path": "/v2/endpoints/{id}/features/colorTemperature/decreaseColorTemperature"
        }
    ]
}

応答本文のパラメーター

フィールド 説明 必須
properties 色温度のプロパティのリスト。現在、サポートされているのはcolorTemperatureInKelvinのみです。各Propertyオブジェクトはポリモーフィズム型です。リストの内容は、クライアントにデータを表示する権限があるかどうかによって異なります。 Propertyオブジェクトのリスト ◯(ただし、空の場合もあります)
operations 指定されたエンドポイントで使用可能な色温度の操作を定義するオブジェクトのリスト。 Operationオブジェクトのリスト ◯(ただし、空の場合もあります)

Propertyオブジェクトのスキーマ

フィールド 説明 必須
name 設定するプロパティの名前。現時点でサポートされる値は、"colorTemperatureInKelvin"のみです。 文字列
type Propertyオブジェクトのタイプ。以下の3つの値がサポートされています。
RETRIEVABLE - Alexaでプロパティの値を取得できます。
NOT_RETRIEVABLE - プロパティで取得がサポートされていません。再試行しても成功しません。
ERROR - エラーにより、Alexaでプロパティの値を取得することができません。再試行すると成功する場合があります。
文字列
value 現在の色温度の値をケルビンで表します。値の範囲は1000~10000です(両端の値を含みます)。 Integer
timeOfSample プロパティ値が取得された日時。 日付
error このフィールドが存在する場合は、プロパティ値の取得中にエラーが発生したことを示します。 オブジェクト

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

Errorオブジェクトのスキーマ

フィールド 説明 必須
type プロパティの取得中に発生したエラーのタイプ。例:ENDPOINT_UNREACHABLEENDPOINT_BUSY。有効なエラータイプについては、エラータイプの値を参照してください。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

features/colorTemperatureを設定する

指定したエンドポイントの色温度の値を設定するには、POST /v2/endpoints/{endpointId}/features/colorTemperature/setColorTemperatureを呼び出します。

指定したエンドポイントの色温度の値を大きくするには、POST /v2/endpoints/{endpointId}/features/colorTemperature/increaseColorTemperatureを呼び出します。この呼び出しでは色温度が調整されますが、変化量の値は指定できません。変化量はサービスの実装または製造元しだいとなります。この呼び出しには、リクエスト本文はありません。

指定したエンドポイントの色温度の値を小さくするには、POST /v2/endpoints/{endpointId}/features/colorTemperature/decreaseColorTemperatureを呼び出します。この呼び出しでは色温度が調整されますが、変化量の値は指定できません。変化量はサービスの実装または製造元しだいとなります。この呼び出しには、リクエスト本文はありません。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/features/colorTemperature/{operation} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須
endpointId エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。 文字列
operation 実行する操作。setColorTemperatureincreaseColorTemperaturedecreaseColorTemperatureのいずれかを指定します。 文字列

setColorTemperatureのリクエスト本文の例

{
    "payload": {
        "colorTemperatureInKelvin": 2700
    }
}

setColorTemperatureのリクエスト本文のパラメーター

フィールド 説明 必須

payload

ペイロードのラッパーオブジェクト。

オブジェクト

payload.colorTemperatureInKelvin

色温度の値。有効な値は1000~10000です(両端の値を含みます)。

整数

成功応答のヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

成功応答本文

操作が完全に成功した場合、応答本文はありません。

部分的な成功応答の例

HTTP/1.1 503 Service Unavailableの応答は、リクエストは正常に送信されたものの、Alexaがエンドポイントレポーターからエラー応答を受け取ったことを示します。エンドポイントのエラーの例として、エンドポイントがオフラインになっている、エンドポイントのバッテリー残量が少なすぎるなどがあります。

HTTP/1.1 503 Service Unavailable
{
    "type": "",
    "message": ""
}

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

Errorオブジェクトのスキーマ

フィールド 説明 必須
type 発生したエラーのタイプ。例:ENDPOINT_UNREACHABLEENDPOINT_BUSY。リクエストは有効だったものの、リクエストを正常に実行できなかった場合にのみ存在します。有効なエラータイプについては、エラータイプの値を参照してください。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

features/powerを取得する

指定したエンドポイントの電源機能のプロパティと、それらに対応する値を取得するには、GET /v2/endpoints/{endpointId}/features/powerを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/power HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

{
   "properties": [
      {
         "name": "powerState",
         "type": "RETRIEVABLE",
         "value": {
             "value": "ON"
         },
         "timeOfSample": "1970-01-01T00:00:00Z"
      }
   ],
   "operations": [
      {
         "name": "turnOn",
         "path": "/v2/endpoints/{endpointID}/features/power/turnOn"
      },
      {
         "name": "turnOff",
         "path": "/v2/endpoints/{endpointID}/features/power/turnOff"
      }
   ]
}

部分的な成功応答の例

以下は、powerStateプロパティの取得中にエラーが発生した場合に返される応答の例です。

{
    "properties": [
        {
            "name": "powerState",
            "type": "ERROR",
            "error": {
                "type": "{ErrorType}",
                "message": "{ErrorMessage}"
            }
        }
    ],
    "operations": [
        {
            "name": "turnOn",
            "path": "/v2/endpoints/{id}/features/power/turnOn"
        },
        {
            "name": "turnOff",
            "path": "/v2/endpoints/{id}/features/power/turnOff"
        }
    ]
}

応答本文のパラメーター

フィールド 説明 必須
properties 電源機能のプロパティ(電源状態など)のリスト。各Propertyオブジェクトはポリモーフィズム型です。たとえば、powerStateプロパティのオブジェクトは、サンプリング時点のエンドポイントの電源状態を表します。 Propertyオブジェクトのリスト
operations 指定されたエンドポイントで使用可能な電源機能の操作を定義するオブジェクトのリスト。 Operationオブジェクトのリスト

Propertyオブジェクトのスキーマ

フィールド 説明 必須
name 設定するプロパティの名前。現時点でサポートされる値は、"powerState"のみです。 文字列
type Propertyオブジェクトのタイプ。以下の3つの値がサポートされています。
RETRIEVABLE - Alexaでプロパティの値を取得できます。
NOT_RETRIEVABLE - プロパティで取得がサポートされていません。再試行しても成功しません。
ERROR - エラーにより、Alexaでプロパティの値を取得することができません。再試行すると成功する場合があります。
文字列
value 現在の電源状態。 ONまたはOFFになります。 文字列
timeOfSample プロパティ値が取得された日時。 日付
error このフィールドが存在する場合は、プロパティ値の取得中にエラーが発生したことを示します。 オブジェクト

Errorオブジェクトのスキーマ

フィールド 説明 必須
type プロパティの取得中に発生したエラーのタイプ。 "DEVICE_UNREACHABLE"または"INTERNAL_ERROR"になります。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

Operationオブジェクトのスキーマ

フィールド 説明 必須
name 操作の名前。電源機能では、"turnOn"または"turnOff"になります。 文字列
path 機能のプロパティを設定するために使用できる完全なパス。 文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

features/powerを設定する

エンドポイントの電源をオンにするには、POST /v2/endpoints/{endpointId}/features/power/turnOnを呼び出します。

エンドポイントの電源をオフにするには、POST /v2/endpoints/{endpointId}/features/power/turnOffを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/features/power/{operation} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須
endpointId エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。 文字列
operation 実行する操作。turnOnまたはturnOffを指定します。 文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

features/temperatureSensorを取得する

指定したエンドポイントのtemperatureSensor機能のプロパティと、それらに対応する値を取得するには、GET /v2/endpoints/{endpointId}/features/temperatureSensorを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/temperatureSensor HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

{
   "name": "temperatureSensor",
   "properties": [
      {
         "name": "temperature",
         "type": "RETRIEVABLE",
         "value": {
            "value": 68.0,
            "scale": "FAHRENHEIT"
         },
         "timeOfSample": "2021-03-04T17:46:42.48Z"
      },
   ]
}

サポートされているプロパティ値

フィールド 説明 必須
temperature.value センサーから報告された温度。 Temperatureオブジェクト

Temperature

フィールド 説明
value 温度です。 Double
scale 温度の単位です。 温度単位文字列です。

温度の値の例

{
    "value": {
        "value": 68.0,
        "scale": "FAHRENHEIT"
    }
}

温度単位

説明
CELSIUS 摂氏です。
FAHRENHEIT 華氏です。
KELVIN ケルビンです。

features/thermostatを取得する

指定したエンドポイントのサーモスタット機能のプロパティと、それらに対応する値を取得するには、GET /v2/endpoints/{endpointId}/features/thermostatを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/thermostat HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例(設定値が1つのサーモスタット)

{
   "name": "thermostat",
   "properties": [
      {
         "name": "thermostatMode",
         "type": "RETRIEVABLE",
         "value": {
            "value": "HEAT"
         },
         "timeOfSample": "2021-03-04T17:46:42.48Z"
      },
      {
         "name": "targetSetpoint",
         "type": "RETRIEVABLE",
         "value": {
            "value": 68.0,
            "scale": "FAHRENHEIT"
         },
         "timeOfSample": "2021-03-04T17:46:42.48Z"
      },
   ],
   "operations": [
      {
         "name": "setThermostatMode",
         "path": "/v2/endpoints/{endpointID}/features/thermostat/setThermostatMode"
      },
      {
         "name": "setTargetSetpoint",
         "path": "/v2/endpoints/{endpointID}/features/thermostat/setTargetSetpoint"
      },
      {
         "name": "adjustTargetSetpoint",
         "path": "/v2/endpoints/{endpointID}/features/thermostat/adjustTargetSetpoint"
      }
   ],
   "configuration": {
      "supportedModes": [
         "HEAT",
         "COOL",
         "AUTO"
      ]
   }
}

応答本文の例(設定値が2つのサーモスタット)

{
   "name": "thermostat",
   "properties": [
      {
         "name": "thermostatMode",
         "type": "RETRIEVABLE",
         "value": {
            "value": "HEAT"
         },
         "timeOfSample": "2021-03-04T17:46:42.48Z"
      },
      {
         "name": "lowerSetpoint",
         "type": "RETRIEVABLE",
         "value": {
            "value": 68.0,
            "scale": "FAHRENHEIT"
         },
         "timeOfSample": "2021-03-04T17:46:42.48Z"
      },
      {
         "name": "upperSetpoint",
         "type": "RETRIEVABLE",
         "value": {
            "value": 73.0,
            "scale": "FAHRENHEIT"
         },
         "timeOfSample": "2021-03-04T17:46:42.48Z"
      }
   ],
   "operations": [
      {
         "name": "setThermostatMode",
         "path": "/v2/endpoints/{endpointID}/features/thermostat/setThermostatMode"
      },
      {
         "name": "setTargetSetpoint",
         "path": "/v2/endpoints/{endpointID}/features/thermostat/setTargetSetpoint"
      }
   ],
   "configuration": {
      "supportedModes": [
         "HEAT",
         "COOL",
         "AUTO"
      ]
   }
}

サポートされているプロパティ値

フィールド 説明 必須
targetSetpoint.value 設定値が1つのサーモスタットの目標温度。 Temperatureオブジェクト
lowerSetpoint.value 設定値が2つのサーモスタットの下限の設定値。 Temperatureオブジェクト
upperSetpoint.value 設定値が2つのサーモスタットの上限の設定値。 Temperatureオブジェクト
thermostatMode.value サーモスタットのモード。 ThermostatMode文字列

Temperature

フィールド 説明
value 温度です。 Double
scale 温度の単位です。 温度単位文字列です。

温度の値の例

{
    "value": {
        "value": 68.0,
        "scale": "FAHRENHEIT"
    }
}

温度単位

説明
CELSIUS 摂氏です。
FAHRENHEIT 華氏です。
KELVIN ケルビンです。

ThermostatModeの値

説明
AUTO 現在の温度と設定温度に基づいた自動暖房および自動冷房モードです。
COOL 冷房モードです。
HEAT 暖房モードです。
ECO エコモードです。
OFF 暖房と冷房はオフですが、デバイスの電源は入っている可能性があります。

サポートされている設定

フィールド 説明 必須
supportedModes デバイスでサポートされているモード。 ThermostatMode文字列の配列

機能の操作

サポートされている操作

フィールド 説明
adjustTargetSetpoint 設定値が1つのサーモスタットの目標設定値を指定の値で調整します。
setTargetSetpoint 指定した設定値にサーモスタットを設定します。
setThermostatMode サーモスタットのモードを設定します。

adjustTargetSetpoint

設定値が1つのサーモスタットの目標設定値を指定の値で調整するには、POST /v2/endpoints/{endpointId}/features/thermostat/adjustTargetSetpointを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/features/thermostat/adjustTargetSetpoint HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文のペイロード

フィールド 説明 必須
targetSetpointDelta サーモスタットの設定値を調整する量。 Temperatureオブジェクト

リクエストの例

POST
/v2/endpoints/amzn1.alexa.endpoint.abc123/features/thermostat/adjustTargetSetpoint HTTP/1.1
Host: api.amazonalexa.com
Authorization: Bearer 
{
   "payload": {
      "targetSetpointDelta": {
         "value": -2.0,
         "scale": "CELSIUS"
      }
   }
}

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

setTargetSetpoint

指定した設定値にサーモスタットを設定するには、POST /v2/endpoints/{endpointId}/features/thermostat/setTargetSetpointを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/features/thermostat/setTargetSetpoint HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文のペイロード

フィールド 説明 必須
targetSetpoint 設定値が1つのサーモスタットの目標設定値。 Temperatureオブジェクト ◯(設定値が1つのサーモスタットの場合)
lowerSetpoint 設定値が2つのサーモスタットの下限の設定値。 Temperatureオブジェクト ◯(設定値が2つのサーモスタットの場合)
upperSetpoint 設定値が2つのサーモスタットの上限の設定値。 Temperatureオブジェクト ◯(設定値が2つのサーモスタットの場合)

リクエストの例(設定値が1つの場合)

POST
/v2/endpoints/amzn1.alexa.endpoint.abc123/features/thermostat/setTargetSetpoint HTTP/1.1
Host: api.amazonalexa.com
Authorization: Bearer 
{
   "payload": {
      "targetSetpoint": {
         "value": 21.0,
         "scale": "CELSIUS"
      }
   }
}

リクエストの例(設定値が2つの場合)

POST
/v2/endpoints/amzn1.alexa.endpoint.abc123/features/thermostat/setTargetSetpoint HTTP/1.1
Host: api.amazonalexa.com
Authorization: Bearer 
{
   "payload": {
      "lowerSetpoint": {
         "value": 68.0,
         "scale": "FAHRENHEIT"
      },
      "upperSetpoint": {
         "value": 72.0,
         "scale": "FAHRENHEIT"
      }
   }
}

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

setThermostatMode

サーモスタットのモードを設定するには、POST /v2/endpoints/{endpointId}/features/thermostat/setThermostatModeを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/features/thermostat/setThermostatMode HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文のペイロード

フィールド 説明 必須
thermostatMode サーモスタットに設定するモード。 ThermostatMode文字列 ◯(設定値が1つのサーモスタットの場合)

リクエストの例(設定値が2つの場合)

POST
/v2/endpoints/amzn1.alexa.endpoint.abc123/features/thermostat/setTargetSetpoint HTTP/1.1
Host: api.amazonalexa.com
Authorization: Bearer 
{
   "payload": {
      "thermostatMode": "HEAT"
   }
}

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 BAD_REQUEST Bad Request 次の理由により、リクエストが無効です:{詳細な理由}。
401 UNAUTHORIZED Authentication Failure LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden 操作を実行する権限がユーザーにありません。
404 NOT_FOUND Not Found パスにエンドポイントが見つかりませんでした。
指定された機能または操作はエンドポイントで使用できません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 ENDPOINT_UNREACHABLE Service Unavailable エンドポイントに到達できません。

speaker機能を管理する

features/speakerを取得する

指定したエンドポイントのスピーカー機能のプロパティと、それらに対応する値を取得するには、GET /endpoints/{endpointID}/features/speakerを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/features/speaker HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

{
   "properties": [
      {
         "name": "volume",
         "type": "RETRIEVABLE",
         "value": {
             "value": 42
         },
         "timeOfSample": "1970-01-01T00:00:00Z"
      }
   ],
   "operations": [
      {
         "name": "setVolume",
         "path": "/v2/endpoints/{endpointID}/features/speaker/setVolume"
      },
      {
         "name": "adjustVolume",
         "path": "/v2/endpoints/{endpointID}/features/speaker/adjustVolume"
      }
   ]
}

部分的な成功応答の例

以下は、volumeプロパティの取得中にエラーが発生した場合に返される応答の例です。

{
    "properties": [
        {
            "name": "volume",
            "type": "RETRIEVABLE",
            "error": {
                "type": "{ErrorType}",
                "message": "{ErrorMessage}"
            }
        }
    ],
    "operations": [
        {
            "name": "setVolume",
            "path": "/v2/endpoints/<id>/features/speaker/setVolume"
        },
        {
            "name": "adjustVolume",
            "path": "/v2/endpoints/<id>/features/speaker/adjustVolume"
        }
    ]
}

応答本文のパラメーター

フィールド 説明 必須
properties スピーカー機能のプロパティ(音量など)のリスト。各Propertyオブジェクトはポリモーフィズム型です。たとえば、volumeプロパティのオブジェクトは、サンプリング時点のエンドポイントのスピーカー音量の状態を表します。 Propertyオブジェクトのリスト
operations 指定されたエンドポイントで使用可能なスピーカー機能の操作を定義するオブジェクトのリスト。 Operationオブジェクトのリスト

Propertyオブジェクトのスキーマ

フィールド 説明 必須
name 設定するプロパティの名前。現時点でサポートされる値は、"volume"のみです。 文字列
type Propertyオブジェクトのタイプ。以下の3つの値がサポートされています。
RETRIEVABLE - Alexaでプロパティの値を取得できます。
NOT_RETRIEVABLE - プロパティで取得がサポートされていません。再試行しても成功しません。
ERROR - エラーにより、Alexaでプロパティの値を取得することができません。再試行すると成功する場合があります。
文字列
value 現在の音量。例:42。有効な範囲は0~100です。 Integer
timeOfSample プロパティ値が取得された日時。 日付
error このフィールドが存在する場合は、プロパティ値の取得中にエラーが発生したことを示します。 オブジェクト

Errorオブジェクトのスキーマ

フィールド 説明 必須
type プロパティの取得中に発生したエラーのタイプ。 "DEVICE_UNREACHABLE"または"INTERNAL_ERROR"になります。 文字列
message プロパティの名前。例:"volume" 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
400 Bad Request リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden アクセストークンは有効ですが、必要なLWAスコープの権限をユーザーが持っていません。
404 Not found リクエストされた構成要素がクライアントについて検出されませんでした。
429 Too many requests サーバーがビジー状態のため、リクエストが制限されました。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。1秒後に再試行し、2回以上は再試行しないでください。
503 Service Unavailable サービスが一時的に使用できません。

features/speakerを設定する

指定したエンドポイントのスピーカー音量を指定の値に設定するには、POST /v2/endpoints/{endpointId}/features/speaker/setVolumeを呼び出します。

指定したエンドポイントのスピーカー音量を指定の値で調整するには、POST /v2/endpoints/{endpointId}/features/speaker/adjustVolumeを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

POST /v2/endpoints/{endpointID}/features/speaker/{operation} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須
endpointId エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。 文字列
operation 指定したエンドポイントのスピーカー機能で公開されているDAAPI操作。setVolumeadjustVolumeのどちらかを指定します。 文字列

setVolumeのリクエスト本文の例

{
    "payload": {
        "volume": 42
    }
}

setVolumeのリクエスト本文のパラメーター

フィールド 説明 必須
volume エンドポイントのスピーカー音量として設定する絶対音量。有効範囲は0~100です。 文字列

adjustVolumeのリクエスト本文の例

{
    "payload": {
        "volumeDelta": -42
    }
}

adjustVolumeのリクエスト本文のパラメーター

フィールド 説明 必須
volumeDelta エンドポイントのスピーカー音量を調整する相対音量。有効な範囲は-100~100です。エンドポイントの音量が既に「20」に設定されている場合、adjustVolume操作を呼び出してエンドポイントの音量を「-30」で調整すると、エンドポイントの音量は0に設定されます。同様に、エンドポイントの音量が既に「20」に設定されている場合、adjustVolume操作を呼び出してエンドポイントの音量を「90」で調整すると、エンドポイントの音量は100に設定されます。 文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード 名前 説明
202 Accepted リクエストが成功しました。
400 Bad Request リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden アクセストークンは有効ですが、必要なLWAスコープの権限をユーザーが持っていません。
404 Not found リクエストされた構成要素がクライアントについて検出されませんでした。
429 Too many requests リクエストが制限されました。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は429以外の応答を受信するまで256秒ごとに再試行します。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。1秒後に再試行し、2回以上は再試行しないでください。
503 Service Unavailable サーバーが一時的に使用できません。

エンドポイントの設定値を照会する

エンドポイントの1つの設定の現在値を照会するには、GET /v2/endpoints/{endpointId}/settings/{settingName}を呼び出します。また、GET /v2/endpoints/{endpointId}/settings?keys={settingNames}&nextToken={nextToken}&maxResults={maxResults}を呼び出すことで、エンドポイントの複数の設定の現在値を照会することもできます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

サポートされている設定

以下の設定がサポートされています。

設定の名前 説明 応答フィールド 応答フィールドの説明 応答フィールドの型
address addressの設定を取得します。 address エンドポイントの所在地の設定。 オブジェクト
Alexa.DoNotDisturb.doNotDisturb DoNotDisturbの設定を取得します。この設定により、通知やプロアクティブなエクスペリエンス(通話など)がユーザーの妨げになるのを防ぐことができます。 enabled DoNotDisturbの設定が有効な場合はtrue、そうでない場合はfalseです。 ブール値
System.locales ユーザーの優先ロケールを取得します。Alexaデバイスのコンテキストでは、この設定により、Alexa搭載デバイスが理解して応答に使用する言語が制御されます。 locales ロケール文字列のリスト。最大2つのロケールを指定できます。リストの最初の要素が優先ロケールです。すべてのロケールですべての種類のスキルが使用できるとは限りません。 リスト
SpeechRecognizer.wakeWords wakeWordsの設定を取得します。この設定は、Alexaの起動に使用できる代替のウェイクワードを制御します。 wakeWords ウェイクワードのリスト。例:["ALEXA"]。Alexaでサポートされているウェイクワードは、ALEXA、AMAZON、COMPUTER、ECHOです。現在、指定できるウェイクワードは一度に1つだけです。注: すべてのデバイスとロケールですべてのウェイクワードがサポートされるとは限りません。フランス(fr-FR)では、COMPUTERはサポートされません。 リスト
SpeechRecognizer.wakeWordConfirmation wakeWordConfirmationの設定を取得します。この設定により、ユーザーは、Alexaがウェイクワードを検出したときに、視覚的な表示だけでなく信号音が再生されるようにするかどうかを指定できます。信号音は、Alexaがリクエストの聞き取りと解釈を開始したことを示します。 wakeWordConfirmation 現在のウェイクワード確認の設定。Alexaでサポートされているウェイクワード確認の設定は、TONEおよびNONEです。 文字列
SpeechRecognizer.speechConfirmation speechConfirmationの設定を取得します。この設定により、ユーザーは、Alexaへのリクエストを言い終えたときに、短い信号音が再生されるようにするかどうかを指定できます。信号音は、Alexaがリクエストの聞き取りと解釈を終了したことを示します。 speechConfirmation 現在の音声認識確認の設定。Alexaでサポートされている音声認識確認の設定は、"TONE"および"NONE"です。 文字列
SpeechRecognizer.FollowUp 会話継続モードの設定を取得します。この設定は、ユーザーがウェイクワードを言わなくても、Alexaがユーザーから続けてリクエストを聞き取ることができるようにします。 FollowUp 会話継続モードが有効な場合はtrue、そうでない場合はfalseです。 ブール値
Alexa.ManagedDevice.Settings.errorSuppression errorSuppressionの設定を取得します。この設定は、特定のエラーに対して、デバイスでオーディオによるエラーの合図(短い特徴的なサウンド)を再生するかどうかを制御します。 errorSuppression エラー抑制のリスト。現時点でサポートされる値は、CONNECTIVITYのみです。リストが空([])の場合、抑制されるエラーはありません。 リスト
Alexa.ManagedDevice.Settings.setupModePrivileges setupModePrivilegesの設定を取得します。この設定は、エンドユーザーがセットアップモードのプロセスを通じて(たとえば、アクションボタンを長押しすることで)デバイスを設定モードにできるかどうかを制御します。 setupModePrivileges セットアップモードの権限のリスト。Alexaでサポートされているセットアップモードの権限のリストは、["ALL_SETTINGS"]です。["ALL_SETTINGS"]では、エンドユーザーがデバイスをセットアップモードにすることができます。空のリスト([])は、セットアップモードが無効であることを示します。 リスト
Alexa.ManagedDevice.Settings.maximumVolumeLimit maximumVolumeLimitの設定を取得します。 maximumVolumeLimit 0~100の数値(両端の値を含みます)。 整数
System.timeZone timeZoneの設定を取得します。 timeZone タイムゾーン文字列。Time Zone Databaseで定義されているOlson形式に従います。例: "America/Los_Angeles" 文字列
System.temperatureUnit temperatureUnitの設定を取得します。 temperatureUnit 温度の文字列。"CELSIUS"または"FAHRENHEIT"です。 文字列
System.distanceUnits distanceUnitsの設定を取得します。 distanceUnits 距離の単位の文字列。"METRIC"または"IMPERIAL"です。 文字列
Accessibility.Captions.AlexaCaptions.enablement AlexaCaptionsの設定を取得します。注: キャプションは、英国(en-GB)とフランス(fr-FR)ではサポートされません。 AlexaCaptions "ENABLED"または"DISABLED"です。 文字列
Accessibility.Captions.ClosedCaptions.enablement ClosedCaptionsの設定を取得します。注: キャプションは、英国(en-GB)とフランス(fr-FR)ではサポートされません。 ClosedCaptions "ENABLED"または"DISABLED"です。 文字列
Accessibility.Display.Magnifier.enablement Magnifierの設定を取得します。注: 拡大鏡は、英国(en-GB)とフランス(fr-FR)ではサポートされません。 Magnifier "ENABLED"または"DISABLED"です。 文字列
Accessibility.Display.ColorInversion.enablement ColorInversionの設定を取得します。注: 色反転は、英国(en-GB)とフランス(fr-FR)ではサポートされません。 ColorInversion "ENABLED"または"DISABLED"です。 文字列

エンドポイントの単一の設定を照会する

エンドポイントの1つの設定の現在値を照会するには、GET /v2/endpoints/{endpointId}/settings/{settingName}を呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/{SettingName} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

応答本文

  {value}

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

エンドポイントの複数の設定を照会する

エンドポイントの複数の設定の現在値を照会するには、GET /v2/endpoints/{endpointId}/settings?keys={settingNames}&nextToken={nextToken}&maxResults={maxResults}を呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエストのクエリパラメーター

フィールド 説明 必須
keys 照会する設定の名前をカンマ区切りで指定します。 文字列
nextToken 次のページを照会するためにクライアントが使用するトークン。 文字列
maxResults このページでクライアントが要求する結果の最大数。 文字列

リクエスト本文

なし。

応答ヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

リクエストの形式

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

GET /v2/endpoints/{endpointId}/settings?keys={settingNames}&nextToken={nextToken}&maxResults={maxResults} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

応答本文

フィールド 説明 必須
paginationContext nextTokenのプロパティを持つオブジェクト。クライアントは、次のページを取得する後続のリクエストにこの値を渡します。nextTokenがない場合は、これが最終ページであることを示します。 文字列
settings keyvalueという2つのプロパティを持つオブジェクトの配列。返される設定の順序は保証されません。 文字列
errors keystatuscodemessageというプロパティをそれぞれ持つオブジェクトの配列。errorsがない場合は、すべての照会が正常に完了し、結果がsettingsに格納されていることを示します。 文字列
{
    "paginationContext": {
        "nextToken": "{nextToken}"
    },
    "settings": [
        {
            "key": "{settingName1}",
            "value": {value1}
        },
        {
            "key": "{settingName2}",
            "value": {value2}
        },
        ...
    ],
    "errors": [
        {
            "status": {status3},
            "key": "{settingName3}",
            "code": "{code3}",
            "message": "{message3}"
        },
        {
            "status": {status4},
            "key": "{settingName4}",
            "code": "{code4}",
            "message": "{message4}"
        },
        ...
    ]
}

エラー応答

HTTP/1.1 {ErrorCode}
{
    "code": "{ErrorCode}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
code エラーコード。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

addressの設定を取得する

エンドポイントの所在地の住所を取得するには、GET /v2/endpoints/{endpointId}/settings/addressを呼び出します。Alexaは、ローカル検索や天気などの機能でこの設定を使用します。詳細については、所在地情報を使用してスキルを拡張するを参照してください。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/address HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

{
    "address": {
        "addressLine1": "221 Baker Ave",
        "addressLine2": "",
        "addressLine3": "",
        "city": "Sunnyvale",
        "stateOrRegion": "California",
        "districtOrCounty": "",
        "postalCode": "94085",
        "countryCode": "US"
    }
}

応答本文のパラメーター

フィールド 説明 必須
address デバイスの所在地の住所。 Address

Addressオブジェクト

パラメーター 説明 必須
addressLine1 住所の1行目です。 文字列
addressLine2 住所の2行目です。 文字列 ◯(空の文字列の場合もあります)
addressLine3 住所の3行目です。 文字列 ◯(空の文字列の場合もあります)
city リクエストで指定されたエンドポイントが所在する市。 文字列
stateOrRegion リクエストで指定されたエンドポイントに関連付けられている州、省、地域の省略形。米国以外の国では、この値は空の文字列になることがあります。 文字列
districtOrCounty デバイスに関連付けられている地域または郡。米国以外の国ではこの値は空文字列になることがあります。 文字列
postalCode リクエストで指定されたエンドポイントの郵便番号。 文字列
countryCode リクエストで指定されたエンドポイントの、2文字の国/リージョンコード。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されました。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は429以外の応答を受信するまで256秒ごとに再試行します。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。
503 Service Unavailable サービスが一時的に使用できません。

DoNotDisturbの設定を取得する

DoNotDisturbの設定を取得するには、GET /v2/endpoints/{endpointId}/settings/Alexa.DoNotDisturb.doNotDisturbを呼び出します。この設定により、通知やプロアクティブなエクスペリエンス(通話など)がユーザーの妨げになるのを防ぐことができます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/Alexa.DoNotDisturb.doNotDisturb HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   true

応答本文の値

ブール値。DoNotDisturbの設定が有効な場合はtrue、そうでない場合はfalseです。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

localesの設定を取得する

ユーザーの優先ロケールを取得するには、GET /v2/endpoints/{endpointId}/settings/System.localesを呼び出します。Alexaデバイスのコンテキストでは、この設定により、Alexa搭載デバイスが理解して応答に使用する言語が制御されます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/System.locales HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   ["en-US", "es-US"]
   ["en-US", "fr-FR"]

応答本文の値

最大2つのロケール文字列を含むリスト。リストの最初の要素が優先ロケールです。すべてのロケールですべての種類のスキルが使用できるとは限りません。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

WakeWordsの設定を取得する

wakeWordsの設定を取得するには、GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWordsを呼び出します。この設定は、ユーザーがAlexaの起動に使用できる代替のウェイクワードを制御します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWords HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   ["ALEXA"]

応答本文の値

現在有効になっているウェイクワードのリスト。例:["ALEXA"]。Alexaでサポートされているウェイクワードは、ALEXA、AMAZON、COMPUTER、ECHOです。現在、指定できるウェイクワードは一度に1つだけです。注: すべてのデバイスとロケールですべてのウェイクワードがサポートされるとは限りません。フランス(fr-FR)では、COMPUTERはサポートされません。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

wakeWordConfirmationの設定を取得する

リクエスト開始時のサウンドの設定を取得するには、GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWordConfirmationを呼び出します。この設定により、ユーザーは、Alexaがウェイクワードを検出したときに、視覚的な表示だけでなく信号音が再生されるようにするかどうかを指定できます。信号音は、Alexaがリクエストの聞き取りと解釈を開始したことを示します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWordConfirmation HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須
endpointId エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。 文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "NONE"

応答の値

現在のウェイクワード確認の設定。Alexaでサポートされているウェイクワード確認の設定は、TONEおよびNONEです。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

SpeechConfirmationの設定を取得する

リクエスト終了時のサウンドの設定を取得するには、GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.speechConfirmationを呼び出します。この設定により、ユーザーは、Alexaへのリクエストを言い終えたときに、短い信号音が再生されるようにするかどうかを指定できます。信号音は、Alexaがリクエストの聞き取りと解釈を終了したことを示します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.speechConfirmation HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "NONE"

応答の値

現在の音声認識確認の設定。Alexaでサポートされている音声認識確認の設定は、"TONE"および"NONE"です。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

errorSuppressionの設定を取得する

エラー抑制のリストを取得するには、GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.errorSuppressionを呼び出します。この設定は、特定のエラーに対して、デバイスでオーディオによるエラーの合図(短い特徴的なサウンド)を再生するかどうかを制御します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.errorSuppression HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   ["CONNECTIVITY"]

応答本文の値

エラー抑制のリスト。現時点でサポートされる値は、["CONNECTIVITY"]のみです。空のリストは、抑制されているエラーがないことを示します。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされた構成要素がクライアントについて検出されませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

setupModePrivilegesの設定を取得する

セットアップモードの権限のリストを取得するには、GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.setupModePrivilegesを呼び出します。この設定は、エンドユーザーがセットアップモードのプロセスを通じて(たとえば、アクションボタンを長押しすることで)デバイスを設定モードにできるかどうかを制御します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.setupModePrivileges HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   ["ALL_SETTINGS"]

応答本文の値

セットアップモードの権限のリスト。Alexaでサポートされているセットアップモードの権限のリストは、["ALL_SETTINGS"]です。["ALL_SETTINGS"]では、エンドユーザーがデバイスをセットアップモードにすることができます。空のリスト([])は、セットアップモードが無効であることを示します。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

maximumVolumeLimitの設定を取得する

最大音量の上限を取得するには、GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.maximumVolumeLimitを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.maximumVolumeLimit HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   42

応答本文の値

0~100の整数値(両端の値を含みます)。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

timeZoneの設定を取得する

タイムゾーンを取得するには、GET /v2/endpoints/{endpointId}/settings/System.timeZoneを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/System.timeZone HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "America/Los_Angeles"

応答本文の値

タイムゾーン文字列。Time Zone Databaseで定義されているOlson形式に従います。例: "America/Los_Angeles"

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

temperatureUnitの設定を取得する

温度単位(摂氏または華氏)の設定を取得するには、GET /v2/endpoints/{endpointId}/settings/System.temperatureUnitを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/System.temperatureUnit HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "CELSIUS"

応答本文の値

温度単位の文字列。 "CELSIUS"または"FAHRENHEIT"です。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

distanceUnitsの設定を取得する

距離の単位(メートル法またはヤード・ポンド法)の設定を取得するには、GET /v2/endpoints/{endpointId}/settings/System.distanceUnitsを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/System.distanceUnits HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "METRIC"

応答本文の値

距離の単位の文字列。 "METRIC"または"IMPERIAL"です。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

AlexaCaptionsの設定を取得する

Alexaのキャプションの設定を取得するには、GET /v2/endpoints/{endpointId}/settings/Accessibility.Captions.AlexaCaptions.enablementを呼び出します。

この設定は、マルチメディアデバイスで以下の情報を表示するかどうかを制御します。

  • Alexaキャプション。AlexaがSpeechSynthesizerを通じて話した内容をテキストで提示します。キャプションは、Alexa Voice Service(AVS)を使用するすべてのドメインで提供されます。
  • AudioPlayerディレクティブで指定されたキャプション。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、イタリア、ドイツ、スペイン

米国、英国、カナダ、フランス、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/Accessibility.Captions.AlexaCaptions.enablement HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "ENABLED"

応答本文の値

設定の現在値を表す文字列。 "ENABLED"または"DISABLED"です。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

ClosedCaptionsの設定を取得する

クローズドキャプションの設定を取得するには、GET /v2/endpoints/{endpointId}/settings/Accessibility.Captions.ClosedCaptions.enablementを呼び出します。

この設定は、マルチメディアデバイスでビデオコンテンツのクローズドキャプションを表示するかどうかを制御します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、イタリア、ドイツ、スペイン

米国、英国、カナダ、フランス、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/Accessibility.Captions.ClosedCaptions.enablement HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "ENABLED"

応答本文の値

設定の現在値を表す文字列。 "ENABLED"または"DISABLED"です。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

Magnifierの設定を取得する

デバイスの拡大鏡の設定を取得するには、GET /v2/endpoints/{endpointId}/settings/Accessibility.Display.Magnifier.enablementを呼び出します。

この設定により、デバイスのユーザーは、画面上の項目を拡大して読みやすくすることができます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、イタリア、ドイツ、スペイン

米国、英国、カナダ、フランス、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/Accessibility.Display.Magnifier.enablement HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "ENABLED"

応答本文の値

設定の現在値を表す文字列。 "ENABLED"または"DISABLED"です。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

ColorInversionの設定を取得する

画面の色反転の設定を取得するには、GET /v2/endpoints/{endpointId}/settings/Accessibility.Display.ColorInversion.enablementを呼び出します。

この設定により、デバイスのユーザーは、画面の表示色を反転させて読みやすくすることができます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、イタリア、ドイツ、スペイン

米国、英国、カナダ、フランス、イタリア、ドイツ、スペイン

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/Accessibility.Display.ColorInversion.enablement HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   "ENABLED"

応答本文の値

設定の現在値を表す文字列。 "ENABLED"または"DISABLED"です。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

複数の設定を取得する

複数の設定の値を取得するには、GET /v2/endpoints/{endpointId}/settings?keys={settingNames}&nextToken={nextToken}&maxResults={maxResults}を呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings?keys={settingNames}&nextToken={nextToken}&maxResults={maxResults} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエストのクエリパラメーター

フィールド 説明 必須
keys 照会する設定の名前をカンマ区切りで指定します。 文字列
nextToken 次のページを照会するためにクライアントが使用するトークン。 文字列
maxResults このページでクライアントが要求する結果の最大数。 文字列

リクエスト本文

なし。

リクエストの例

GET /v2/endpoints/{endpointId}/settings?keys=System.temperatureUnit,System.distanceUnits,Alexa.DoNotDisturb.doNotDisturb,System.timeZone HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文のエラー

HTTP応答コードが200の場合、個々の設定に対する照会が失敗している可能性があります。その場合は応答本文にエラーと詳細が含まれます。

ステータス コード 説明
204 NO_CONTENT 設定は存在していますが、値が含まれていません。
403 ACCESS_DENIED 特定の設定にアクセスする権限がありません。
404 INVALID_KEY 設定のキーが存在しないか、無効です。
500 INTERNAL_SERVER_ERROR 内部サービスエラーのため、特定の設定の照会を処理できませんでした。

応答本文の例

{
    "paginationContext": {},
    "settings": [
        {
            "key": "System.distanceUnits",
            "value": "IMPERIAL"
        },
        {
            "key": "System.temperatureUnit",
            "value": "CELSIUS"
        }
    ],
    "errors": [
        {
            "status": 204,
            "key": "System.timeZone",
            "code": "NO_CONTENT",
            "message": "Setting value is empty"
        },
        {
            "status": 403,
            "key": "Alexa.DoNotDisturb.doNotDisturb",
            "code": "ACCESS_DENIED",
            "message": "The access to the specific setting is unauthorized"
        }
    ]
}

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

FollowUpの設定を取得する

会話継続モードの設定を取得するには、GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.FollowUp.modeを呼び出します。有効な値は、trueまたはfalseです。この設定は、ユーザーがウェイクワードを言わなくても、Alexaがユーザーから続けてリクエストを聞き取ることができるようにします。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/SpeechRecognizer.FollowUp.mode HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   true

応答本文の値

現在の会話継続モードの設定。trueまたはfalseになります。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

speakingRateの設定を取得する

話す速度の設定を取得するには、GET /v2/endpoints/{endpointId}/settings/SpeechSynthesizer.speakingRateを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/SpeechSynthesizer.speakingRate HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文の例

   0.75

応答本文の値

応答本文には話す速度が含まれます。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
204 No content 設定は存在していますが、値が含まれていません。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

エンドポイントの設定値を更新する

エンドポイントのほとんどの設定の現在値は、PUT /v2/endpoints/{endpointId}/settings/{settingName}を呼び出すことで更新できます。ただし、addressの設定は例外で、この設定にはPOSTを使用します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

サポートされている設定

以下の設定がサポートされています。

設定の名前 説明 リクエストフィールド リクエストフィールドの説明 リクエストフィールドの型
address addressの設定を更新します。 address デバイスの所在地の住所。 オブジェクト
Alexa.DoNotDisturb.doNotDisturb DoNotDisturbの設定を更新します。この設定により、通知やプロアクティブなエクスペリエンス(通話など)がユーザーの妨げになるのを防ぐことができます。 enabled DoNotDisturbの設定が有効な場合はtrue、そうでない場合はfalseです。 ブール値
System.locales ユーザーの優先ロケールを更新します。Alexaデバイスのコンテキストでは、この設定により、Alexa搭載デバイスが理解して応答に使用する言語が制御されます。 locales ロケール文字列のリスト。最大2つのロケールを指定できます。リストの最初の要素が優先ロケールです。すべてのロケールですべての種類のスキルが使用できるとは限りません。 リスト
SpeechRecognizer.wakeWords wakeWordsの設定を更新します。この設定は、ユーザーがAlexaの起動に使用できる代替のウェイクワードを制御します。 wakeWords ウェイクワードのリスト。例:["ALEXA"]。Alexaでサポートされているウェイクワードは、ALEXA、AMAZON、COMPUTER、ECHOです。現在、指定できるウェイクワードは一度に1つだけです。注: すべてのデバイスとロケールですべてのウェイクワードがサポートされるとは限りません。フランス(fr-FR)では、COMPUTERはサポートされません。 リスト
SpeechRecognizer.wakeWordConfirmation wakeWordConfirmationの設定を更新します。この設定により、ユーザーは、Alexaがウェイクワードを検出したときに、視覚的な表示だけでなく信号音が再生されるようにするかどうかを指定できます。信号音は、Alexaがリクエストの聞き取りと解釈を開始したことを示します。 wakeWordConfirmation ウェイクワード確認の新しい設定。Alexaでサポートされているウェイクワード確認の設定は、"TONE"および"NONE"です。 文字列
SpeechRecognizer.speechConfirmation speechConfirmationの設定を更新します。この設定により、ユーザーは、Alexaへのリクエストを言い終えたときに、短い信号音が再生されるようにするかどうかを指定できます。信号音は、Alexaがリクエストの聞き取りと解釈を終了したことを示します。 speechConfirmation 現在の音声認識確認の設定。Alexaでサポートされている音声認識確認の設定は、"TONE"および"NONE"です。 文字列
SpeechRecognizer.FollowUp 会話継続モードの設定を更新します。この設定は、ユーザーがウェイクワードを言わなくても、Alexaがユーザーから続けてリクエストを聞き取ることができるようにします。 FollowUp 会話継続モードが有効な場合はtrue、そうでない場合はfalseです。 ブール値
Alexa.ManagedDevice.Settings.errorSuppression errorSuppressionの設定を更新します。この設定は、特定のエラーに対して、デバイスでオーディオによるエラーの合図(短い特徴的なサウンド)を再生するかどうかを制御します。 errorSuppression エラー抑制のリスト。現時点でサポートされる値は、CONNECTIVITYのみです。リストが空([])の場合、抑制されるエラーはありません。 リスト
Alexa.ManagedDevice.Settings.maximumVolumeLimit maximumVolumeLimitの設定を更新します。 maximumVolumeLimit 0~100の数値(両端の値を含みます)。 整数
System.timeZone timeZoneの設定を更新します。 timeZone タイムゾーン文字列。Time Zone Databaseで定義されているOlson形式に従います。例: "America/Los_Angeles" 文字列
System.temperatureUnit temperatureUnitの設定を更新します。 temperatureUnit 温度の文字列。"CELSIUS"または"FAHRENHEIT"です。 文字列
System.distanceUnits distanceUnitsの設定を更新します。 distanceUnits 距離の単位の文字列。"METRIC"または"IMPERIAL"です。 文字列
Accessibility.Captions.AlexaCaptions.enablement AlexaCaptionsの設定を更新します。注: キャプションは、英国(en-GB)とフランス(fr-FR)ではサポートされません。 AlexaCaptions "ENABLED"または"DISABLED"です。 文字列
Accessibility.Captions.ClosedCaptions.enablement ClosedCaptionsの設定を更新します。注: キャプションは、英国(en-GB)とフランス(fr-FR)ではサポートされません。 ClosedCaptions "ENABLED"または"DISABLED"です。 文字列
Accessibility.Display.Magnifier.enablement Magnifierの設定を更新します。注: 拡大鏡は、英国(en-GB)とフランス(fr-FR)ではサポートされません。 Magnifier "ENABLED"または"DISABLED"です。 文字列
Accessibility.Display.ColorInversion.enablement ColorInversionの設定を更新します。注: 色反転は、英国(en-GB)とフランス(fr-FR)ではサポートされません。 ColorInversion "ENABLED"または"DISABLED"です。 文字列

リクエストの形式

GET /v2/endpoints/{endpointId}/settings/{SettingName} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   {value}

応答ヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

addressの設定を更新する

エンドポイントの所在地の住所を設定するには、POST /v2/endpoints/{endpointId}/settings/addressを呼び出します。Alexaは、ローカル検索や天気などの機能でこの設定を使用します。詳細については、所在地情報を使用してスキルを拡張するを参照してください。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/settings/address HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

{
    "address": {
        "addressLine1": "221 Baker Ave",
        "addressLine2": "",
        "addressLine3": "",
        "city": "Sunnyvale",
        "stateOrRegion": "California",
        "districtOrCounty": "",
        "postalCode": "94085",
        "countryCode": "US"
    }
}

リクエスト本文のパラメーター

フィールド 説明 必須
address デバイスの所在地の住所。 Address

Addressオブジェクト

パラメーター 説明 必須
addressLine1 住所の1行目です。 文字列
addressLine2 住所の2行目です。 文字列 ◯(空の文字列の場合もあります)
addressLine3 住所の3行目です。 文字列 ◯(空の文字列の場合もあります)
city リクエストで指定されたエンドポイントが所在する市。 文字列
stateOrRegion リクエストで指定されたエンドポイントに関連付けられている州、省、地域の省略形。米国以外の国では、この値は空の文字列になることがあります。 文字列
districtOrCounty デバイスに関連付けられている地域または郡。米国以外の国ではこの値は空文字列になることがあります。 文字列
postalCode リクエストで指定されたエンドポイントの郵便番号。 文字列
countryCode リクエストで指定されたエンドポイントの、2文字の国/リージョンコード。 文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
Location: {location}

応答ヘッダーの例

Host: api.amazonalexa.com
X-Amzn-RequestId: 6006f07b-539f-4924-869a-2f8bcf60bdf6
Content-Type: application/json
Location: /v2/endpoints/{endpoint-id}/settings/address

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列
Location 作成された住所への相対パス。 文字列

応答本文のパラメーター

addressSuggestionsパラメーターとaddressErrorsパラメーターは相互に排他的です。

パラメーター 説明 必須
address デバイスの所在地の住所。 Address 201の場合は◯、400の場合はオプション
addressSuggestions 入力された住所が無効な場合、住所候補を表します。 住所候補のリスト 400の場合のオプション
addressErrors 入力された住所が無効な場合、住所エラーを表します。 住所エラーのリスト 400の場合のオプション

成功応答本文の例

{
    "address": {
        "addressLine1": "221 Baker Ave",
        "addressLine2": "",
        "addressLine3": "",
        "city": "Sunnyvale",
        "stateOrRegion": "California",
        "districtOrCounty": "",
        "postalCode": "94085",
        "countryCode": "US"
    }
}

エラー応答本文の例: 400の住所候補

リクエストの形式が正しくないか、必須パラメーターが不足している場合、この操作は、住所候補のリストを信頼度の高い順に返します。

{
  "addressSuggestions": [
      {
        "address": {
          "addressLine1":"221 Baker Ave",
          "addressLine2": "",
          "addressLine3": "",
          "city":"Sunnyvale",
          "stateOrRegion":"California",
          "districtOrCounty": "",
          "postalCode":"94085",
          "countryCode":"US"
        }
      }
  ],
  "code": 400,
  "description": "The input address is invalid.Suggested valid addresses are included in the response."
}

エラー応答本文の例: 400の住所エラー

リクエストの形式が正しくないか、必須パラメーターが不足している場合、この操作は住所エラーのリストを返します。

{
  "addressErrors": [
      {
        "code": "FIELD_REQUIRED|FIELD_INVALID",
        "subCode": "ADDRESS_STREET_INCOMPLETE|...",
        "message": "{human-readable message}",
        "element": "ADDRESS_1|ADDRESS_2|..."
      }
    ],
  "code": 400,
  "description": "The input address is invalid.The list of errors is included in the response."
}

Address Errorsオブジェクト

パラメーター 説明 必須
code エラーコード。 列挙
subCode 住所要素が無効である理由に関する追加情報。 列挙
message ユーザーが読める形式のメッセージ。 文字列
element エラーになっている住所要素。 列挙

住所エラーのcodeの値

codeの値 説明
ELEMENT_REQUIRED 必須要素がありません。要素名はelementフィールドで指定されます。
ELEMENT_INVALID フィールド内の値が無効です。要素名はelementフィールドで指定されます。

住所エラーのsubCodeの値

subCodeの値 説明
ADDRESS_PRIMARY_RANGE_MISSING_OR_INVALID 住所の番号が正しくありません。
ADDRESS_STREET_INCOMPLETE 通りの名前が完全ではありません。
ADDRESS_LINES_JUNK_DATA 住所の行のフィールドに不要なデータが含まれています。
ADDRESS_FIELD_LENGTH_HIGH 住所フィールドの長さが許容範囲を超えています。
ADDRESS_CITY_INVALID 指定された州に該当する名前の市がありません。
ADDRESS_COUNTY_INVALID 指定された郡が正しくありません。
ADDRESS_STATE_INVALID 指定された州が正しくありません。
ADDRESS_ZIP_INVALID 指定された州、市、通りに対して、指定された郵便番号が正しくありません。
ADDRESS_STREET_NOT_FOUND 指定された市に該当する通りがありません。
ADDRESS_MULTIBYTE_CHARACTERS フィールドにマルチバイト文字が含まれています。
ADDRESS_DOOR_LEVEL_INFO_MISSING 住所に各戸レベルの情報がありません。
FIELD_EMPTY 必須フィールドが入力されていません。

住所要素の値

住所要素 説明
ADDRESS_1 住所の1行目。
ADDRESS_2 住所の2行目(ある場合)。
ADDRESS_3 住所の3行目(ある場合)。
STREET_NAME 住所に含まれている通りの名前。
BUILDING_NUMBER 建物番号。
COMPLEMENT アパートの部屋番号など、建物内のユニットの番号。
NEIGHBORHOOD 市内の小区域を表します。
CITY 住所が属している市や地方自治体。
STATE 住所が属している米国の州または領土。
COUNTRY 住所が属している国。
ZIP 住所の5桁または9桁の郵便番号。
COUNTY 住所が属している郡。
COUNTRY_CODE 住所の国コード。

HTTP応答コード

ステータスコード 名前 説明
201 Accepted リクエストが成功しました。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。または、入力された住所が無効で、住所候補が提示されています。詳細については、エラー応答本文の例: 400の住所候補およびエラー応答本文の例: 400の住所エラーを参照してください。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
429 Too many requests リクエストが制限されました。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は429以外の応答を受信するまで256秒ごとに再試行します。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。
503 Service Unavailable サービスが一時的に使用できません。

DoNotDisturbの設定を更新する

DoNotDisturbの設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/Alexa.DoNotDisturb.doNotDisturbを呼び出します。この呼び出しにより、通知やプロアクティブなエクスペリエンス(通話など)がユーザーの妨げになるのを防ぐことができます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/Alexa.DoNotDisturb.doNotDisturb HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   true

リクエスト本文の値

ブール値。DoNotDisturbの設定を有効にする場合はtrue、無効にする場合はfalseを指定します。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされた構成要素がクライアントについて検出されませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

localesの設定を更新する

ロケールの設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/System.localesを呼び出します。Alexaデバイスのコンテキストでは、この設定により、Alexa搭載デバイスが理解して応答に使用する言語が制御されます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/System.locales HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   ["en-US", "es-US"]
   ["en-US", "fr-FR"]

リクエスト本文の値

ロケール文字列のリスト。少なくとも1つ、最大2つのロケールを指定します。リストの最初の要素で優先ロケールを指定します。サポートされているロケールは、en-CA、en-GB、en-US、fr-FR、fr-CAです。このAPIでは、en-US/fr-FR、fr-FR/en-US、en-CA/fr-CA、fr-CA/en-CAの言語ペアもサポートされます。すべてのロケールですべての種類のスキルが使用できるとは限りません。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

wakeWordsの設定を更新する

wakeWordsの設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWordsを呼び出します。この設定は、Alexaの起動に使用できる代替のウェイクワードを制御します。

サポートされているウェイクワードは、 ALEXA、AMAZON、COMPUTER、ECHOです。現在、指定できるウェイクワードは一度に1つだけです。注: すべてのデバイスとロケールですべてのウェイクワードがサポートされるとは限りません。フランス(fr-FR)では、COMPUTERはサポートされません。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWords HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   ["ALEXA"]

リクエスト本文の値

ウェイクワードのリスト。例:["ALEXA"]。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

wakeWordConfirmationの設定を更新する

リクエスト開始時のサウンドの設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWordConfirmationを呼び出します。この設定により、ユーザーは、Alexaがウェイクワードを検出したときに、視覚的な表示だけでなく信号音が再生されるようにするかどうかを指定できます。信号音は、Alexaがリクエストの聞き取りと解釈を開始したことを示します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.wakeWordConfirmation HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "NONE"

リクエスト本文の値

ウェイクワード確認の新しい設定を含む文字列。Alexaでサポートされているウェイクワード確認の設定は、"TONE"および"NONE"です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

speechConfirmationの設定を更新する

リクエスト終了時のサウンドの設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.speechConfirmationを呼び出します。この設定により、ユーザーは、Alexaへのリクエストを言い終えたときに、短い信号音が再生されるようにするかどうかを指定できます。信号音は、Alexaがリクエストの聞き取りと解釈を終了したことを示します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.speechConfirmation HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "NONE"

リクエスト本文の値

音声認識確認の新しい設定を含む文字列。Alexaでサポートされている音声認識確認の設定は、"TONE"および"NONE"です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

errorSuppressionの設定を更新する

エラー抑制のリストを更新するには、PUT /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.errorSuppressionを呼び出します。この設定は、特定のエラーに対して、デバイスでオーディオによるエラーの合図(短い特徴的なサウンド)を再生するかどうかを制御します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.errorSuppression HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   ["CONNECTIVITY"]

リクエスト本文の値

エラー抑制のリスト。現時点でサポートされる値は、["CONNECTIVITY"]のみです。空のリストは、抑制されるエラーがないことを示します。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされた構成要素がクライアントについて検出されませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

maximumVolumeLimitの設定を更新する

最大音量の上限を更新するには、PUT /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.maximumVolumeLimitを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/Alexa.ManagedDevice.Settings.maximumVolumeLimit HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   42

リクエスト本文の値

0~100の整数値(両端の値を含みます)。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

timeZoneの設定を更新する

タイムゾーンを更新するには、PUT /v2/endpoints/{endpointId}/settings/System.timeZoneを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/System.timeZone HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "America/Los_Angeles"

リクエスト本文の値

タイムゾーン文字列。Time Zone Databaseで定義されているOlson形式に従います。例: "America/Los_Angeles"

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

temperatureUnitの設定を更新する

温度単位(摂氏または華氏)の設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/System.temperatureUnitを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/System.temperatureUnit HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "CELSIUS"

リクエスト本文の値

温度単位の文字列。 "CELSIUS"または"FAHRENHEIT"です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

distanceUnitsの設定を更新する

距離の単位(メートル法またはヤード・ポンド法)の設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/System.distanceUnitsを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ

米国、英国、フランス、カナダ、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/System.distanceUnits HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "METRIC"

リクエスト本文の値

距離の単位の文字列。 "METRIC"または"IMPERIAL"です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

AlexaCaptionsの設定を更新する

Alexaのキャプションの設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/Accessibility.Captions.AlexaCaptions.enablementを呼び出します。

この設定は、マルチメディアデバイスで以下の情報を表示するかどうかを制御します。

  • Alexaキャプション。AlexaがSpeechSynthesizerを通じて話した内容をテキストで提示します。キャプションは、Alexa Voice Service(AVS)を使用するすべてのドメインで提供されます。
  • AudioPlayerディレクティブで指定されたキャプション。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、イタリア、ドイツ

米国、英国、カナダ、フランス、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/Accessibility.Captions.AlexaCaptions.enablement HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "ENABLED"

リクエスト本文の値

この設定の新しい値を表す文字列。 "ENABLED"または"DISABLED"です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

ClosedCaptionsの設定を更新する

クローズドキャプションの設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/Accessibility.Captions.ClosedCaptions.enablementを呼び出します。

この設定は、マルチメディアデバイスでビデオコンテンツのクローズドキャプションを表示するかどうかを制御します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、イタリア、ドイツ

米国、英国、カナダ、フランス、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/Accessibility.Captions.ClosedCaptions.enablement HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "ENABLED"

リクエスト本文の値

この設定の新しい値を表す文字列。 "ENABLED"または"DISABLED"です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

Magnifierの設定を更新する

デバイスの拡大鏡の設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/Accessibility.Display.Magnifier.enablementを呼び出します。

この設定により、デバイスのユーザーは、画面上の項目を拡大して読みやすくすることができます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、イタリア、ドイツ

米国、英国、カナダ、フランス、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/Accessibility.Display.Magnifier.enablement HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "ENABLED"

リクエスト本文の値

この設定の新しい値を表す文字列。 "ENABLED"または"DISABLED"です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

ColorInversionの設定を更新する

画面の色反転の設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/Accessibility.Display.ColorInversion.enablementを呼び出します。

この設定により、デバイスのユーザーは、画面の表示色を反転させて読みやすくすることができます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、カナダ、イタリア、ドイツ

米国、英国、カナダ、フランス、イタリア、ドイツ

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/Accessibility.Display.ColorInversion.enablement HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   "ENABLED"

リクエスト本文の値

この設定の新しい値を表す文字列。 "ENABLED"または"DISABLED"です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

応答ヘッダーのパラメーター

フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

FollowUpの設定を更新する

会話継続モードの設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.FollowUp.modeを呼び出します。有効な値は、trueまたはfalseです。この設定は、ユーザーがウェイクワードを言わなくても、Alexaがユーザーから続けてリクエストを聞き取ることができるようにします。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/SpeechRecognizer.FollowUp.mode HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   false

リクエスト本文の値

会話継続モードの新しい設定。trueまたはfalseを指定します。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

speakingRateの設定を更新する

話す速度の設定を更新するには、PUT /v2/endpoints/{endpointId}/settings/SpeechSynthesizer.speakingRateを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

PUT /v2/endpoints/{endpointId}/settings/SpeechSynthesizer.speakingRate HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の例

   0.75

リクエスト本文の値

話す速度の新しい設定。有効な値は、 0.750.8511.251.51.752です。デフォルトの設定は1です。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

応答本文

なし。

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード 名前 説明
204 No content 設定が適用されました。
400 Bad Request (INVALID_REQUEST, INVALID_VALUE, DEVICE_UNREACHABLE, DEVICE_NOT_SUPPORTED) リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたエンドポイントが見つかりませんでした。
405 Method Not Allowed デバイスで設定がサポートされていません。
429 Too many requests リクエストが制限されています。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。

エンドポイントの登録を解除する

Amazonビジネスアカウントからエンドポイントの登録を解除するには、POST /v2/endpoints/{endpointId}/deregisterを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/deregister HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエスト本文

なし。

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

応答本文

なし。

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。例:1K82TJNQTXSJFP8NGJP0。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

エラー応答

HTTP/1.1 {ErrorCode}
{
    "type": "{ErrorType}",
    "message": "{ErrorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラータイプ。 文字列
message エラーのエラーメッセージ。
注: エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。
文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
400 Bad Request リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。
401 Unauthorized アクセストークンがないか、期限切れか、無効です。
403 Forbidden アクセストークンは有効ですが、必要なLWAスコープの権限をユーザーが持っていません。
429 Too many requests リクエストが制限されました。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は429以外の応答を受信するまで256秒ごとに再試行します。
500 Internal Server Error 内部サービスエラーのためリクエストを処理できませんでした。1秒後に再試行したら、エクスポネンシャルバックオフを行い、待機間隔が256秒になったら、以降は500以外の応答を受信するまで256秒ごとに再試行します。
503 Service Unavailable サービスが一時的に使用できません。

エンドポイントのフレンドリー名を変更する

エンドポイントのフレンドリー名を変更するには、POST /v2/endpoints/{endpointId}/friendlyNameを呼び出します。Alexaは、GUIとVUIのすべてのエクスペリエンスでフレンドリー名を使用します。ユーザーは、エンドポイントを制御するときにフレンドリー名を使用できます。たとえば、「アレクサ、{フレンドリー名}をオンにして」のように言うことができます。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/friendlyName HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文の形式

{
  "type": "PLAIN",
  "value": {
    "text": "{friendlyNameString}"
  }
}

リクエスト本文の例

{
  "type": "PLAIN",
  "value": {
    "text": "ライト"
  }
}

リクエスト本文のパラメーター

フィールド 説明 必須
type 名前の値のタイプ。現時点でサポートされる値は、"PLAIN"のみです。 文字列
value エンドポイントのフレンドリー名を含むValueオブジェクト。 Value

Valueオブジェクト

フィールド 説明 必須
text フレンドリー名の文字列。文字列は1~128文字のUnicode(UTF-8)文字で構成されている必要があり、特殊文字や句読点を含めることはできません(アポストロフィは使用できます)。以下のルールが適用されます。
* 使用できる文字は、数字、文字(漢字や非ラテン文字も許容されます)、空白、アポストロフィです。
* 名前には、1文字以上の数字または文字が含まれている必要があります。
文字列

応答ヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

エラー応答本文の形式

{
     "type" :  "{errorType}" ,
     "message" :  "{errorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
type エラーのエラータイプ。リクエストは有効だったものの、サービスがリクエストの実行に失敗した場合にのみ存在します。このフィールドはビジネスロジックで使用できます。 文字列
message エラーのエラーメッセージ。エラーメッセージはデバッグやログ記録のみを目的としたものです。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。 文字列

HTTP応答コード

ステータスコード メッセージ 説明
200 OK リクエストが成功しました。  
400 INVALID_FRIENDLY_NAME The input friendly name has the following problems: {problemString} リクエストに1つ以上の必須パラメーターがないか、1つ以上のパラメーターの値が無効です。
400 DUPLICATE_NAME The input friendly name is already assigned to another device. フレンドリー名は一意でなければなりません。
401 UNAUTHORIZED Invalid or missing access token LWAトークンがないか、期限切れか、無効です。
403 FORBIDDEN Forbidden クライアントはリソースのリストを取得できますが、リソースの名前を変更する権限がありません。
404 NO_SUCH_ENDPOINT Endpoint not found パスにエンドポイントが存在しないか、クライアントにリソースのリストを取得する権限がありません。
429 TOO_MANY_REQUESTS Too Many Requests リクエストが制限されました。1秒後に再試行し、待機間隔が256秒になるまでエクスポネンシャルバックオフを実行して、それ以降は429以外の応答を受信するまで256秒ごとに再試行してください。
500 INTERNAL_SERVER_ERROR Internal Service Error サービスエラーが発生しました。
503 SERVICE_UNAVAILABLE Service Unavailable サービスが一時的に利用不可能なため、リクエストを処理できません。

エンドポイントの情報を削除する

エンドポイントの情報を削除するには、POST /v2/endpoints/{endpointId}/forgetを呼び出します。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国、英国、フランス、カナダ、イタリア、ドイツ、スペイン

米国

リクエストの形式

POST /v2/endpoints/{endpointId}/forget HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {LWA Token}

リクエストのパスパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

リクエスト本文

なし。

応答ヘッダー

HTTP/1.1 200 OK
Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須
X-Amzn-RequestId リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。 文字列

エラー応答本文の形式

{
    "message": "{errorMessage}"
}

エラー応答のパラメーター

フィールド 説明 必須
message エラーのエラーメッセージ。 文字列

HTTP応答コード

ステータスコード 名前 説明
200 OK リクエストが成功しました。
400 Bad Request リクエストに1つ以上の必須パラメーターがないか、1つ以上のパラメーターの値が無効です。
401 Unauthorized LWAトークンがないか、期限切れか、無効です。
403 Forbidden 操作を実行する権限がユーザーにありません。
404 Not found リクエストされたリソースが見つからないか、クライアントにアクセス権がありません。
429 Too many requests リクエストが制限されました。自動的な再試行は行わないでください。サービスが復旧するまで待ってから操作を再試行してください。
500 Internal Server Error サービスエラーが発生しました。1秒後に再試行し、待機間隔が256秒になるまで、ジッターを追加しながらエクスポネンシャルバックオフを実行してください。それ以降は、500以外の応答を受信するまで256秒ごとに再試行してください。
503 Service Unavailable サービスが一時的に利用不可能なため、リクエストを処理できません。

エンドポイントのすべてのタイマーを削除する

エンドポイントのすべてのタイマーを削除するには、DELETE /v1/alerts/timers?endpoint={endpointId}を呼び出します。ユニット内のすべてのエンドポイントのタイマーを削除するには、[ユニットのすべてのタイマーを削除する] (../alexa-smart-properties/unit-api.html#delete-all-timers-for-unit)を参照してください。

この操作は以下の国で使用できます。

Healthcare Hospitality Senior Living Core

米国

カナダ、ドイツ、スペイン、フランス、イタリア、米国、英国

カナダ、ドイツ、スペイン、フランス、イタリア、米国、英国

なし

リクエストの形式

DELETE /v1/alerts/timers?endpoint={endpointId} HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: {LWA Token}

リクエスト本文

なし。

リクエストのパラメーター

フィールド 説明 必須

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

応答ヘッダー

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json
フィールド 説明 必須

X-Amzn-RequestId

リクエストの一意のID。問題が発生する場合、Amazonはこの値をトラブルシューティングに使用します。

文字列

応答

削除に成功すると、サーバーからHTTP 204 No Contentステータス応答が返されます。成功ペイロードには本文は含まれません。

Host: api.amazonalexa.com
X-Amzn-RequestId: {request-id}
Content-Type: application/json

エラー応答

HTTP/1.1 {ErrorCode}
Content-Type: application/json

{
    "errors": [{
        "type": "{ErrorType}",
        "endpointId": "{EndpointId}",
        "message": "{ErrorMessage}"
    }]
}

エラー応答のパラメーター

フィールド 説明 必須

type

エラー名。例:DEVICE_UNREACHABLE

文字列

endpointId

エンドポイントID。"amzn1.alexa.endpoint.{id}"というAmazon Common Identifier(ACI)形式で表します。

文字列

message

エラーのエラーメッセージ。エラーメッセージはデバッグやログ記録のみを目的としたものです。ユーザーには表示しないようにする必要があります。エラーメッセージの内容に依存するビジネスロジックを構築しないようにする必要があります。

文字列

HTTP応答コード

ステータスコード 名前 説明

204

No content

エンドポイントでタイマーが正常に削除されました。このステータスコードは、エンドポイントに削除するタイマーがない場合でも返されます。

400

BAD_REQUEST

リクエストの形式が正しくないか、1つ以上の必須パラメーターがありません。

401

UNAUTHORIZED

認証トークンが無効か、リソースに対するアクセス権限がありません。

403

FORBIDDEN

操作を実行する権限がユーザーにないか、ユニットが存在しません。

404

NOT FOUND

リクエストされたリソースが見つからないか、クライアントにアクセス権がありません。

500

INTERNAL_SERVER_ERROR

内部サービスエラーのためリクエストを処理できませんでした。

504

DEVICE_NOT_REACHABLE

デバイスがオフラインか到達不能です。


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

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