question

ReyS avatar image
ReyS asked

Wanted: Feedback on Skill Validation API

We recently announced the Skill Validation API (beta). You can validate example phrases via ASK CLI or through SMAPI using the Skill Validation API. The API runs a set of tests to validate your skill before submission for certification or at any time during development.

The Skill Validation API is offered as a beta and may improve or change as we receive feedback and iterate on the feature. In this post, you can provide feedback for the Skill Validation API.

Things to consider when providing feedback:

  • Was the API/CLI easily understandable?
  • Are the results easily understandable?
  • Is the documentation understandable?
  • What other validations would be helpful for your skill?
  • Did the validations make it easier to certify?
  • What will you use the validations tests for? Primarily as pre-certification? Regular testing?
  • Other feedback to improve the Skill Validation API
alexa skills kitask clismapi
10 |5000
Toggle Comment visibility. Current Visibility: Viewable by all users

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

2 Answers

jadimmock avatar image
jadimmock answered

Hey,

Thanks for the API, it looks really useful. Some early feedback:

  • The documented URLs do not include version info (i.e. /v1). Presumably the version is required? If so, please could you update the URLs, as per the other API docs.
  • The introduction to the API states that "Each API request must have an Authorization header", and yet none of the sample request headers in the documentation includes this header. It includes some other headers, such as `X-Amzn-Authorization`, but I'm not sure they're correct?
  • The successful response status is inconsistent with the skill status API - on this API it is `SUCCESSFUL`, on the skill status API it is `SUCCEEDED`.

Will post any other feedback as I find it :).

Cheers,

James

10 |5000
Toggle Comment visibility. Current Visibility: Viewable by all users

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Paul Webster avatar image
Paul Webster answered

I am working on a Skill for the first time.

I would like to call the validator but am not ready to send it to a real person to have it checked.
Is this a "private" operation - i.e. does not lead to an accidental submission before I am ready?

10 |5000
Toggle Comment visibility. Current Visibility: Viewable by all users

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.