In the API Settings section for a specific API, the end point of the API on the API Gateway is displayed. This is the endpoint you will use in your application (see also your applications) to speak to the API with.
In case the API is secured via the OAuth 2.0 Implicit Grant Flow, this section will also include the Authorization Server you will need to redirect to in order to retrieve an access token for the API into your Client Side application (e.g. JavaScript SPA).
See also the API Index Help Page for a discussion on the different ways of accessing a secured API, using API Keys or the OAuth 2.0 Client Credentials Flow.
Click on the "Description" headline to display a description of the API. This section also contains a link to the "Swagger" documentation of the end points of the specific API. If you use this button (and not the "Try it" buttons described below), you will retrieve a read only documentation of the API, in Swagger UI. Swagger UI is also able to let you actually interact with the API, but that requires a subscription.
The "Applications" section contains all your registered applications (see also application help page), and their relation to the current API. In case you have existing subscriptions, you will be able to display the credentials for this API. In case you don't have a subscription for the API for a specific application, you may add a subscription by clicking the Subscribe button.
In case an application having a subscription to the API, this is also the place where you can Unsubscribe from the API, in case you have the appropriates rights to do so. In the table of applications, the following information will be displayed:
Information | Description |
---|---|
Application | The list of your applications will be displayed here. |
Plan | In case the application has a subscription to the current API, the selected subscription Plan will be displayed here. Hover with the mouse above it, or click it, to display information on the selected plan. |
API Key or Client ID and Secret | In case you have an active subscription to the API, the API credentials are displayed here. You will need to click the reveal button () to actually show the keys. |
Action | This is the action you can perform with the application; either "Subscribe", "Unsubscribe", or none of both, e.g. if you are only have a Reader role on the application. |
Try it! | Click the "Try it!" button to view the Swagger documentation of the API in interactive mode. This button is only availabel in case the application has a current subscription to the API. |