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

Skill Certification and Publishing

 

Use the following API operations in the Skill Management API (SMAPI) to submit a skill for certification and publishing, withdraw a skill from certification, or unpublish (hide or remove) a published skill.

The SMAPI endpoint is https://api.amazonalexa.com. Each API request must have an Authorization header whose value is the access token retrieved from Login with Amazon.

Submit a skill for certification

Submit a skill for certification and potential publication.

Request

POST /v1/skills/{skillId}/submit

Parameter Description

Field Description Parameter Type Required?
skillId Unique identifier of skill. Path Yes

Response

HTTP/1.1 202 Accepted

Headers

Location: "<relative path to track submission status>"

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 Server Error
HTTP/1.1 503 Service Unavailable

Withdraw a skill from certification

Withdraw a skill from the certification process.

Request

POST /v1/skills/{skillId}/withdraw

Body

{
  "reason" : "OTHER",
  "message" : "TEST SKILL"
}

Parameter Description

Field Description Parameter Type Required?
skillId Unique identifier of skill. Path Yes
reason One of the following enum values indicating the reason for the withdrawal: TEST_SKILL, MORE_FEATURES, DISCOVERED_ISSUE, NOT_RECEIVED_CERTIFICATION_FEEDBACK, NOT_INTEND_TO_PUBLISH, OTHER Request Body Element Yes
message String that indicates why the skill is being withdrawn, when OTHER is specified as a reason. Request Body Element Yes, for reason OTHER, otherwise no.

Response

HTTP/1.1 204 No Content

Exceptions

HTTP/1.1 400 Bad Request
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 Server Error
HTTP/1.1 503 Service Unavailable

Hide or remove a live skill

Use this operation to unpublish (hide or remove) a published skill.

When you unpublish a skill, you choose whether to hide or remove the skill.

After you receive a response indicating that the operation succeeded, it might take a few days before the unpublishing is complete.

To republish a skill after you unpublish it, you must resubmit the skill for certification.

Request

POST /v1/skills/{skillId}/unpublish

Body

{
  "type": "string",
  "reason": "string"
}

Parameter Descriptions

Field Description Parameter Type Required?
skillId Unique identifier of the skill to unpublish. Path Yes
type

Specifies whether to hide or remove the skill. Valid values are HIDE and REMOVE. For more information, see Hide or Remove a Skill.

Request body element Yes
reason

The reason for unpublishing the skill. Provide one of the following reasons:

  • Changing invocation name
  • Don't want to maintain my skill
  • Published by mistake
  • Technical issues
  • Other
Request body element Yes

Response

HTTP/1.1 202 Accepted

Body

{
  "message": "string"
}

Parameter Description

Field Description Parameter Type
message A message returned in the response. Response body element

Exceptions

HTTP/1.1 400 Bad Request
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 Server Error
HTTP/1.1 503 Service Unavailable