Contents

Popular
 Contents

Fiorano REST API

Fiorano provides REST APIs to help manage and monitor the Fiorano API Management product externally using user-defined clients performing pre-defined API calls.

How to access ?

Fiorano REST APIs are documented using Swagger. To access the swagger JSON file for REST APIs of the API Management Server, please make sure that the API Management Server is running and use the following URL format:

Swagger JSON file URL

Icon

http://<IP Address>:<1981>/api/ams/swagger.json

Icon

While accessing from a different machine, provide the IP Address in the JSON URL present in the Explore text field of the Swagger UI.


Figure 1: Swagger UI Explore text field to change the machine IP address

Testing the REST APIs using SWAGGER UI

Fiorano's REST APIs can be tested directly through Swagger UI on the installed service provider:

Icon

All the requests and responses are in JSON format.

  1. To access the SWAGGER UI, make sure that the API Management server is running and visit the following URL to access the Swagger UI page

    Swgger UI URL

    Icon

    http://<IP Address>:1981/swaggerui

  2. Generate an API Key to execute any call on the Swagger UI:

    1. In the swagger UI, go to the Security tab for the server whose calls need to be tested and select the /security/apikey row. The row expands and shows an execution panel.

      Image1. Try it out
      Figure 2: Swagger UI testing screen

    2. Click Try it out and provide username and password for the server.

      Provide API as context for the API Management Server.

      Generate API Json Input
      Figure 3: JSON Input to generate API Key

    3. Click Execute, the response will return the API key.

Similarly, all the REST calls can be tested using this pre-generated API Key and the parameters mentioned in the self explanatory execution panels of each call.

RESR API Calls

API Analytics

These APIs help in managing the analytics of the API server. Using these APIs, the analytics data can be fetched, data that may not be needed can be deleted, reports and notifications can be created/removed/fetched etc.


Figure 4: List of API Analytics APIs

API Policy

API Policy refers to the various actions that can be performed when an API call reaches the server. These APIs can manage actions that needs to be performed on receipt of a new backend API call being managed by the product.


Figure 5: List of API Policy APIs

API Projects

These APIs help in managing the API Projects. Using these APIs, projects can be imported/exported/deployed/undeployed and details regarding the project like deployment status, environment, policies used, jetty access URL etc. can be fetched.


Figure 6: List of API Projects APIs

API Products, Client Developers, and Client Subscriptions (Developer Application)

These APIs help in managing API Products, Developers and Subscriptions. Users can add/remove/change products, developers or subscriptions, and get information like developer's email ID, product details, developer details, subscription details, etc.  


Figure 7: List of API Product APIs

API Trace

These APIs help in controlling trace modules of the product. Using these APIs, tracing can be started/stopped and get configuration of the module for a particular project in an environment. 


Figure 8: List of API Trace APIs

Servers

These APIs help in managing the servers of the API Management product, using these APIs, servers can be started/stopped and details such as system details, memory details, patches, logs etc can be fetched.


Figure 9: List of Servers APIs

Adaptavist ThemeBuilder EngineAtlassian Confluence