Using Postman to test your requests

1. Download the Postman application from the web.
2. Open the Postman application and click the Environment tab on the left side of the application.
3. Select the Globals option in the newly shown panel located to the right of the Environment tab.
4. Now, we will add two variables, these two variables will be globals throughout Postman and help you do the operations that you need to do with the API. You can refer to the table at the end of this section or just follow the steps below.
1. Add a new variable and name it baseUrl, which will be used to link your Postman to the Arbjournal API. Copy-paste the URL, https://api.getarbjournal.com/v1, into the Initial Value column.
2. Add another variable named bearerToken, you will need this one in a following step. This variable is used to authenticate you to be allowed to send requests to our API via what we call a Bearer Token. To retrieve a key, go to Settings > API Keys, generate a key and paste it into the Initial Value column.
3. Be sure that you click on the Save button at the top right corner of the Globals panel.

VARIABLE	INITIAL VALUE	CURRENT VALUE
baseUrl	https://api.getarbjournal.com/v1	https://api.getarbjournal.com/v1
bearerToken	{GENERATED_KEY}	{GENERATED_KEY}

5. Now press the Import button which is located above the panel where you just added the global variables.
1. In the newly shown window, click the Link tab and copy the URL (or all of its content), https://api.getarbjournal.com/v1/openapi.json, into the Enter a URL field and then click Continue and follow the steps to proceed to the importation.
2. Now, a new collection named ArbJournal API should be imported giving you access to all our API endpoints.
6. Before testing any endpoint, please make sure the API key is defined in the Bearer Token area. Bearer Token allows requests to authenticate using an access key.
1. Select the root of the ArbJournal API collection and then click the Authorization tab and select Bearer Token in the dropdown list named Type.
2. In the Token field, write the name of the second global variable (bearerToken) you have created in a previous step and surround it with two curly braces like this: {{bearerToken}}.

Here's how to test your Postman configuration

You should now be all set up but, just to be sure, we'll do one simple request to the API to verify if all the previous steps were done properly. If anything went wrong, just contact our support team and they will help you with the steps.

1. Expand the ArbJournal API collection.
2. Expand the locations node.
3. Click on the one named List locations and in the GET section, just remove all the parameters to have the following: {{baseUrl}}/locations and click the Send button.
4. In the Response part of the screen, normally at the bottom, you should have a JSON response containing your organization's locations.