WSO2 API Cloud documentation is getting a whole new look at
Try WSO2 Cloud for Free
Sign in

All docs This doc
Skip to end of metadata
Go to start of metadata

An API prototype is created for the purpose of early promotion and testing. You can deploy a new API or a new version of an existing API as a prototype. It gives subscribers an early implementation of the API that they can try out without a subscription, and provide feedback to improve. After a period of time, publishers can make changes the users request and publish the API.

In this tutorial, you deploy a new version of an API as a prototype and observe how subscribers can see it in the API Store and how the prototyped API behaves in the Store.

The examples here use the API PhoneVerification 2.0.0, which is created in the previous tutorial.

 A video tutorial of the tutorials in this section is available here.

  1. Log in to the API Publisher and select the API (e.g., PhoneVerification 2.0.0) that you want to prototype. 

    After creating a new version of an API, you typically deploy it as a prototype for the purpose of testing and early promotion. 
  2. Click the Lifecycle tab of the API and click Deploy as a Prototype

    Tip: You can also prototype an API by going to its edit mode in the API Publisher, then the Implement tab and then clicking Deploy as a Prototype under the Prototyped API section.

  3. Log in to the API Store and click the newly prototyped API to open it.

  4. The APIs Overview page opens. Note the following: 
    • There are no subscription options.
    • There are two sets of URLs (with and without the version). This is because you marked the 2.0.0 version as the default version in step 4 of the previous tutorial.
    • Other features like documentation, social media and forums are available.
  5. Click the API Console tab and note that the POST method is not available as we removed that in the new version. 
    Let's invoke the prototyped API.

  6. In the API Console of the prototyped API, expand the GET method, give the parameter values (e.g., PhoneNumber: 18006785432 and LicenseKey: 0) and invoke the API.

  7. Note the response that appears in the console. You do not have to subscribe to the API or pass an authorization key to invoke a prototyped API. 

  8. Similarly, try to invoke the 1.0.0 version of the API without an access token (delete the token that is automatically populated).

  9. Note that you get an authentication error as "Missing credentials."

You have prototyped an API and tested it along with its older and published versions. In the next tutorial, you publish the prototyped API and deprecate its older versions.

  • No labels