SMAPIで開発を始める


SMAPIで開発を始める

Alexaスキル管理API(SMAPI)は、Alexaスキル管理タスクをプログラムで実行できるRESTful HTTPインターフェースを提供します。スキル管理タスクには、スキルの新規作成や対話モデルの更新などがあります。APIは、Login with Amazonを使用して呼び出し元を認証します。認証された開発者はすべて、ユーザーに代わってAlexaスキルの作成や更新を行うツールやサービスの開発ができるようになります。ASK CLIは、そうしたツールの1つです。

スキル管理APIの認証スキームは、開発者がAPIアクセス権限をツールやサービスに委譲する用途に最適化されています。

Alexaスキル管理API

APIに統合するツールやサービスを独自に開発している場合、Login with AmazonにOAuth 2.0を統合する必要があります。ユーザーの認可をリクエストしたり、スキル管理APIの呼び出しに使用するアクセストークンを取得したりするには、このOAuth 2.0を使用します。APIにはauthorization code Grant種別が必要です。アクセストークンの取得方法と、ツールがリクエストできるOAuthスコープの詳細については、SMAPIで使用するアクセストークンの取得方法を参照してください。

APIエンドポイント

このAPIのルートエンドポイントは、https://api.amazonalexa.comです。Login with Amazonから取得したアクセストークンを、各REST APIリクエストのAuthorizationヘッダーに指定する必要があります。

スキル管理用REST API

以下のSMAPI REST APIを使用して、スキルに関する操作を実行できます。

スキルテスト用REST API

以下のSMAPI REST APIを使用して、スキルをプログラムでテストできます。

オブジェクトスキーマ

AlexaスキルをASK CLIまたはSMAPIで管理する場合、各リソースはJSON形式で表記する必要があります。

詳細については、以下のリファレンスを参照してください。

SMAPI SDK

SMAPIはNode.js、Python、JavaのSMAPI SDKでも使うことができます。SMAPI SDKを用いて任意のスキル管理APIを呼び出すことで、スキルをプログラムで管理できます。使用方法については、以下のリファレンスを参照してください。


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

最終更新日: 2023 年 05 月 15 日