What is Postman?
Postman is a free-to-use visual editing tool for building and testing the API requests. As opposed to other methods for interacting with APIs (e.g., using cURL), Postman allows you to easily edit API requests, view header information, and much more. To make it easy for our clients to get up and running with our REST APIs, we created a collection of our API endpoints with examples.BQE Core API collection using OAuth 2.0.
How to use Postman
- Create an app on the Developer Portal.
- Download and install Postman: https://www.getpostman.com
- Click the Run in Postman button as shown above.
- Configure the Postman Authorization header
- Set up your environment
Configuring the Postman environment
You are provided with an environment template in the collection accessed via Manage Environments of the Postman setting. You can also add a new environment by clicking Manage Environments at the top-right corner of Postman.
When configuring your environment, enter the variable name and specify Initial and Current values for it – by default, the current value will copy the initial value.
Client Id of your app on the BQE Core Developer Portal
Client Secret of your app on the BQE Core Developer Portal
Configuring the Postman Authorization header
Postman must generate an OAuth 2.0 access token based on OAuth 2.0 keys from your app’s dashboard on .
- Sign in to your developer account on BQE Core Developer Portal and click Apps
- Open the app you want to use.
- Click the app list and navigate to Keys Use these keys for the configuration.
Go to the Authorization tab on the Postman UI, select OAuth 2.0 for Type and click Get New Access Token.
Use the information below when configuring the Postman Authorization dialog:
|Postman Field||Developer Portal Information|
A user defined name for the token
Use https://www.getpostman.com/oauth2/callback. This must also be configured as a Redirect URI in your app on the Developer Portal
|Access Token URL||/connect/token|
|Client ID and Secret||Obtain these values from your app via Developer Portal|
|Scope||readwrite:core offline_access openid email profile|
|State||Authorization protocols provide a state parameter. During authentication, the application sends this parameter in the authorization request and the Authorization Server will return this parameter unchanged in the response.|
|Client Authentication||Send as basic Auth Header|
Using the pre-built requests from the collection
After you have configured your environment, you can use any of the pre-built requests from our collection. To start using the pre-built requests, simply click on any of the Core API module within the ‘Collection’ menu on the left side of Postman. This will open the request as a new tab in the main window of the Postman app.
In general, there are two types of requests that Core API endpoints accept - GET and POST. Depending on which HTTP method the endpoint uses, you’ll need to edit the pre-built request differently.
Edit a POST request
When editing a POST request, you’ll need to open the request and navigate to the Body section in the request editor. For readability, select the raw tab to format the JSON request body.
Edit a GET request
When editing a GET request, you will need to edit the parameters passed in the request URL. To edit these easily, select the Params tab next to the Auth tab and edit the key-value pairs in the fields that will appear below the URL bar.
Send Your Request
When your API request is ready, click the ‘Send’ button next to the URL bar. The request is sent and the response data is populated in a section underneath the request editor. From here, you can view the raw data returned from Core API, see the HTTP response code, see how long the request took to process, and view header information.