| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Postman is an API platform that you can use to access the APIs. It can be downloaded from https://www.postman.com/downloads/ and you can select to either run it in a downloadable app or in the browser.
...
Create an Application Access in Usage Engine as described in Configuring Application Access. Ensure to copy the Client Secret since it will only be visible when creating the Application Access.
Either download the Postman app, or select to run it in a browser, and create an account and sign in.
The API specification can be downloaded from the Usage Engine API page for your environment Environments. The detailed documentation of the API is available on the same endpoint.
Go to the workspace and import the OPEN API openapi.json specification in postman Postman as a Postman collectionCollection.
Before accessing any API, you must create a bearer token must be created. This can be done using a Create access token API in the authentication section.Add a Base URL(endpoint for your environment), Client Id and Client Secret as a variable in your postman configuration. We recommend using a Postman variable for client Id, Client secret and token value.
Send a request to generate token.
Save the generated token as a variable.
Go to the API that you want to send request. In this case, we show Usage metering List Meter Type API.
Go to Authorization tab, select Bearer token and variable used to save bearer token.
Update the body and query parameters as desired and send a request.
.
Select which endpoint you want to start using, for example List meter types. Navigate to Authorization tab, select OAuth 2.0 as the authentication type. Configure getting the token by using
{{baseUrl}}/authentication/v1/oauth/token(baseURL can be found in Environments ) and with the information provided by the Application Access. Pay attention Usage Engine CE Authorization endpoint uses "Send client credentials in body" as the Client Authentication method. We recommend using variables as in the example below.
Add an additional Key in the token request named
audience. Configure this to match the base url of the environment you are using Environments.
Note!
If the request are failing, check the URL for the audience variable to contain the ending slash to the environment.
Once happy with you configurations, press “Get New Access Token”. This will generate a new access token.
Press proceed or wait a couple of seconds. Now you will be presented with the newly created access token. Press “Use Token”.
The token will now be added to the authorization header of your endpoint.
Update the body and query parameters with relevant parameters and send the request.
You can now create, list, update or delete the API endpoints provided by Usage Engine.
For more information on postman variables and environments, refer to Postman variable and environment. You can save the configuration of various environment like sandbox and production using environments in Postman.