...
- Log in to the API Store Web interface (https://localhost:9443/store) and click the API published before (
FindFeeds
). - The API opens. Under the API Console tab, you can find the interactive documentation for
FindFeeds
. - Click on GET operation of 'feeds/1.0.0/top_rated' to expand it. There, you can enter the Authorization Headers, Parameters and click Try it out to invoke.
- The response appears. For example,
...
- In the API Publisher, go to the Doc tab of
FindFeeds
API to see its API definition. Click Edit Content. API definition contains the JSON representation of the API. You can easily modify existing content, add/remove elements, change paths and parameters etc. using the JSON editor.
Info - API Manager 1.5.0 onwards has integrated JSONMate as the editor for modifying the API Definition.
- For the Swagger specification of API declaration, see https://github.com/wordnik/swagger-core/wiki/API-Declaration.
There are Two ways to modify the API Defnition. You can either use the Text Editor given, or the graphical tree editor.
By default, all the POST and PUT operations have the
Payload
parameter, which you can use to send any payload when invoking the API. The GET, DELETE operations haveQuery parameters
, which you can use to send URL-appended parameters (ex: v=2&length=200). You can also add named parameters. For example, to modify the path of the API created above with a parameter, edit the path and add the relevant parameter.Let's say that you want to send a query parameter called 'v' in the GET request of
top_rated
resource. The screenshot below showspath
modified with a parameter. And also Also, the default Query Parameter is changed to a parameter calledv
.Text Editor
You can just modify the JSON content according to Swagger Specification.
Graphical Editor
If you would like to use the graphical editor here is the way to do. To add new elements, click Add New Value and provide the value. To delete elements, delete the value of Key. For example, if you delete Key value description, that element will be deleted.
Also be sure to modify descriptions, notes, summary on each of the operations.
Once the modifications are done, save.
Log in to the API Store and click on GET operation to expand it. There you can enter the parameters and try it out.
...