Contents

Popular

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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::

Info
titleSwagger JSON file URL

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

Note

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

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

Testing the REST APIs using SWAGGER UI

...

  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

    Info
    titleSwgger UI URL

    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 12: Swagger UI testing screen

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

      Info
      iconfalse

      Provide API as context for the API Management Server.

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

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

...

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