Vielen Dank für deinen Besuch. Diese Seite ist nur in Englisch verfügbar.

Skill Enablement

This API is used to enable custom skills programmatically, rather than from the developer portal. The developer can interact with the enablement as with other sub-resources. The API's endpoint is https://api.amazonalexa.com. Each API request must have an Authorization header whose value should be the access token retrieved from Login with Amazon.

Enable a skill

Enables a skill stage for the requestor. The requestor should be either a developer or the owner of the skill. Only a single skill stage can be enabled for a given user at one time. If another stage of a skill is already enabled for the requestor, this API will automatically disable the stage that has already been enabled and enable the stage input value in the request.

Request

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

Parameters

FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. One of: development, live. PathYes

Response

HTTP/1.1 204 No Content

Exceptions

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

Check enablement status of a skill

Checks whether a skill stage is enabled or not for the requestor. It returns 204 if the skill stage is enabled, and 404 otherwise.

Request

GET /v1/skills/{skillId}/stages/{stageName}/enablement
FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. One of: development, live. PathYes

Response

HTTP/1.1 204 No Content

Exceptions

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

Disable a skill

Disables a skill by deleting the skill enablement. If no skill enablement exists, then the skill must be enabled through the developer portal, unless another skill enablement is created.

Request

DELETE /v1/skills/{skillId}/stages/{stageName}/enablement
FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. One of:development, live. PathYes

Response

HTTP/1.1 204 No Content

Exceptions

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