SMAPIで開発を始める
Alexaスキル管理API(SMAPI)は、Alexaスキル管理タスクをプログラムで実行できるRESTful HTTPインターフェースを提供します。スキル管理タスクには、スキルの新規作成や対話モデルの更新などがあります。APIは、Login with Amazonを使用して呼び出し元を認証します。認証された開発者はすべて、ユーザーに代わってAlexaスキルの作成や更新を行うツールやサービスの開発ができるようになります。ASK CLIは、そうしたツールの1つです。
スキル管理APIの認証スキームは、開発者がAPIアクセス権限をツールやサービスに委譲する用途に最適化されています。
SMAPI(スキル管理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
です。以下の各API操作に表示されるパスはrootに続けて記述する必要があります。Login with Amazonから取得したアクセストークンは、各リクエストのAuthorization
ヘッダーに格納されます。
オブジェクトスキーマ
AlexaスキルをASK CLIまたはSMAPIで管理する場合、各リソースをJSON形式で表記する必要があります。
関連トピック:
SMAPI SDK
SMAPIはNode.js、Python、JavaのSMAPI SDKでも使うことができます。SMAPI SDKを用いて任意のスキル管理APIを呼び出すことで、スキルをプログラムで管理できます。使用方法については以下を確認してください。