Bluetooth APIリファレンス

Bluetooth APIリファレンス

Bluetooth APIを使用すると、Alexa搭載デバイスからBluetooth機能のプロパティを取得したり、Bluetoothデバイスとのペアリングを解除したりできます。

APIエンドポイント

Bluetooth APIのエンドポイントは、https://api.amazonalexa.comです。

認証

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

操作

Bluetooth APIには、以下の操作が用意されています。

操作 HTTPメソッドとURI

Bluetooth機能を取得する

GET /v2/endpoints/{id}/features/bluetooth

すべてのBluetoothデバイスとAlexa搭載デバイスとのペアリングを解除する

POST /v2/endpoints/{endpointId}/features/bluetooth/unpair

Bluetooth機能を取得する

Bluetooth機能のプロパティ、操作、設定を取得します。

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

Healthcare Hospitality Residential Senior Living Core

なし

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

米国、カナダ

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

なし

リクエスト

Bluetooth機能のプロパティ、操作、設定を取得するには、/v2/endpoints/{id}/features/bluetoothリソースへのGETリクエストを行います。

リクエストヘッダーの例

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

GET /v2/endpoints/{id}/features/bluetooth HTTP/1.1
Host: api.amazonalexa.com
Authorization: Bearer {access token}

リクエストヘッダーのパラメーター

パラメーター 説明 型 必須

access token

LWAトークン。

文字列

◯

id

エンドポイントID。IDはamzn1.alexa.endpoint.{id}形式で指定してください。

文字列

◯

リクエスト本文の例

リクエストの本文はありません。

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

リクエストの本文はありません。

応答

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

応答本文の例

以下は、応答の例です。

HTTP/1.1 200 OK
{
  "operations": [
    {
       "name": "unpair",
       "path": "/v2/endpoints/{id}/features/bluetooth/unpair"
    }
   ]
}

応答本文のパラメーター

パラメーター 説明 型

properties

呼び出し元が使用できる、サポートされているプロパティ。現在、noneのみです。

オブジェクトのリスト

operations

呼び出し元が使用できる、サポートされている操作。現在、unpairのみです。

Operationオブジェクトのリスト。

operations[*].name

操作名。現在、unpairのみです。

文字列

operations[*].path

操作を呼び出すための完全なパス。

文字列

configuration

呼び出し元にアクセスできる設定データ。現在、noneのみです。

設定オブジェクトのリスト。

HTTPステータスコード

ステータス 説明

200 Success

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

400 Bad Request

リクエストの形式が正しくないか、必須パラメーターがありません。

401 Unauthorized

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

403 Forbidden

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

404 Not Found

エンドポイントが見つからないか、指定された機能または操作はエンドポイントで使用できません。

429 Too Many Requests

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

500 Internal Server Error

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

すべてのBluetoothデバイスとAlexa搭載デバイスとのペアリングを解除する

すべてのBluetoothデバイスとAlexa搭載デバイスとのペアリングを解除します。

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

Healthcare Hospitality Residential Senior Living Core

なし

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

米国、カナダ

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

なし

リクエスト

Bluetoothデバイスとのペアリングを解除するには、/v2/endpoints/{endpointId}/features/bluetooth/unpairリソースへのPOSTリクエストを行います。

リクエストヘッダーの例

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

POST /v2/endpoints/{endpointId}/features/bluetooth/unpair HTTP/1.1
Host: api.amazonalexa.com
Authorization: Bearer {access token}

リクエストヘッダーのパラメーター

パラメーター 説明 型 必須

access token

LWAトークン。

文字列

◯

endpointId

エンドポイントID。IDはamzn1.alexa.endpoint.{id}形式で指定してください。

文字列

◯

リクエスト本文の例

リクエストの本文はありません。

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

リクエストの本文はありません。

応答

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

応答本文の例

応答の本文はありません。

応答本文のパラメーター

応答の本文はありません。

HTTPステータスコード

ステータス 説明

202 OK

デバイスとのペアリングが解除されました。

400 Bad Request

リクエストの形式が正しくないか、必須パラメーターがありません。

401 Unauthorized

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

403 Forbidden

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

404 Not Found

エンドポイントが見つからないか、指定された機能または操作はエンドポイントで使用できません。

429 Too Many Requests

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

500 Internal Server Error

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

503 Service Unavailable

エンドポイントにアクセスできません。

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