あなたのAlexaコンソール
?
サポート

スキル有効化(スキル管理API)

スキル有効化(スキル管理API)

開発者ポータルではなく、プログラムでスキルを有効にするためのAPIです。開発者は、その他のサブリソースと同様、対話で有効化します。

スキルを有効にする

リクエスターのスキルステージを有効にします。リクエスターはスキルの開発者または所有者である必要があります。1回に有効にできるスキルステージは、ユーザーにつき1つのみです。リクエスターの別のスキルステージがすでに有効な場合、APIはHTTP/1.1 403 Forbiddenレスポンスを返します。

リクエスト

PUT /v1/skills/{skillId}/stages/{stageName}/enablement

パラメーター

フィールド説明パラメーターの型
skillId一意のスキルIDです。パス
stageスキルのステージを表示します。有効な値は、development(大文字小文字の区別あり)です。パス

応答

HTTP/1.1 204 No Content

例外

HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden
HTTP/1.1 404 Not Found
HTTP/1.1 409 Conflict
HTTP/1.1 500 Internal Service Error
HTTP/1.1 503 Service Unavailable

スキルの有効化ステータスの確認

リクエスターのスキルステージが有効かどうかを確認します。スキルステージが有効な場合は204、そうでない場合は404を返します。

リクエスト

GET /v1/skills/{skillId}/stages/{stageName}/enablement
フィールド説明パラメーターの型
skillId一意のスキルIDです。パス
stageスキルのステージを表示します。有効な値は、development(大文字小文字の区別あり)です。パス

応答

HTTP/1.1 204 No Content

例外

HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden
HTTP/1.1 404 Not Found
HTTP/1.1 429 Too Many Requests
HTTP/1.1 500 Internal Service Error
HTTP/1.1 503 Service Unavailable

スキルを無効にします

スキル有効化を削除すると、スキルを無効にできます。スキル有効化が存在しない場合、別のスキル有効化を作成しないのであれば、開発者ポータルからスキルを有効にする必要があります。

リクエスト

DELETE /v1/skills/{skillId}/stages/{stageName}/enablement
フィールド説明パラメーターの型
skillId一意のスキルIDです。パス
stageスキルのステージを表示します。有効な値は、development (大文字小文字の区別あり)です。パス

応答

HTTP/1.1 204 No Content

例外

HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden
HTTP/1.1 404 Not Found
HTTP/1.1 429 Too Many Requests
HTTP/1.1 500 Internal Service Error
HTTP/1.1 503 Service Unavailable