Create an API with an Inline Script

In this tutorial, you create an API with an inline script, deploy it as a prototype and invoke it using the API Console integrated in the API Store. You create APIs with inline scripts typically for testing purposes.

1. Log in to the API Publisher.
2. Select the option to design a new API and click Start Creating.
   

3. Give the information in the table below. To add resources, click the Add button.

   Field		Sample value
   Name		Location_API
   Context		/location
   Version		1.0.0
   Resources	URL pattern	{town}
   	Request types	GET

   

4. After the resource is added, expand its GET method and note that a parameter by the name town is added under the resource. You use it to pass the payload to the backend. Once done, click Next: Implement >.
   

5. In the Prototyped API section under the Implement tab, select the implementation method as Inline.
   

   The inline JavaScript engine does not provide support for SOAP APIs. If you opt for the endpoint implementation method instead of inline, you need to provide an endpoint to a prototype API. For example, http://ws.cdyne.com/phoneverify/phoneverify.asmx

6. Expand the GET method and give the following as the script. It reads the payload that the user sends with the API request and returns it as a JSON value.

   mc.setProperty('CONTENT_TYPE', 'application/json');
   var town = mc.getProperty('uri.var.town');
   mc.setPayloadJSON('{ "Town" : "'+town+'"}');

   

7. Click Deploy as a Prototype.

8. Go to the API Store and note that the newly deployed API is listed there.

   Tip: You can invoke prototyped APIs without signing in to the API Store or subscribing to the API. The purpose of a prototype is advertising and giving an early implementation for users to test.

   

9. Click the API to open it and go to its API Console tab.
   

10. Expand the GET method, give any value for the town (say London) and invoke the API.
    

11. Note the payload you gave as a JSON output in the response.
    

You have created an API with inline script, deployed it as a prototype and invoked it through the integrated API Console.

An API can also be prototyped by moving the API to the prototyped state in the API lifecycle. For more information, see the Deploy and Test as a Prototype tutorial.