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.

Run in Postman BQE Core API collection using OAuth 2.0.

How to use Postman

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.

manage_environments

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.

Variable Value

baseUrl

redirectUri

https://www.getpostman.com/oauth2/callback

authorizeUrl

/connect/authorize

tokenUrl

/connect/token

redirectUri

https://www.getpostman.com/oauth2/callback

clientId

Client Id of your app on the BQE Core Developer Portal

clientSecret

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.

edit_collection

Use the information below when configuring the Postman Authorization dialog:

Postman Field Developer Portal Information

Token Name

A user defined name for the token

Grant Type

Authorization Code

Callback URL

Use https://www.getpostman.com/oauth2/callback. This must also be configured as a Redirect URI in your app on the Developer Portal

Auth URL

/connect/authorize

Access Token URL /connect/token
Client ID and Secret Obtain these values from your app via Developer Portal
Scopereadwrite: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.

collections

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.

post

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.

get

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.

send