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.
To access your APIs using Postman:
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.
Go to the workspace and import the OPEN API specification. The API specification can be downloaded from the endpoint of your environment Environments .
Click on the REST API basics tutorial, and your workspace opens with a basic set of requests; GET, POST, PUT, DEL.
Select one of the methods and click on the Authorization tab to configure the application authentication.
Click on the Type drop-down and select OAuth 2.0.
Scroll down to the Configure New Token section.
Paste the Client ID and Client Secret details from the Configuring Application Access Application Access you created in Usage Engine in the first step.
Note!
You will see a warning advising you to use variables instead of entering the credentials in clear text. If you want to use variables, you can set this up by clicking on the Environments option in the navigation panel to the left in Postman.
Select Client Credentials in the Grant type drop-down.
Enter https://auth.digitalroute.io/auth/token in the Access Token URL field.
Define the audience of the token by scrolling down to the Token Request section select audience as Key in the table, enter the URL to the Usage Engine APIs, https://api.us.digitalroute.io/ in the Value field and leave the default setting Request Body in the Send In field as is.
Save your Authorization configuration to a collection by clicking on the Save button top right and either select an existing Collection, or create a new one.
Click on the Get New Access Token button.
If everything went well you will get a message saying “Authentication complete” and the Manage Access Tokens dialog will open displaying your token details.
Click on the Use Token button top right and close the dialog.
You can now create, list, update or delete the API endpoints provided by Usage Engine.