11.1. Getting Postman ready

Postman Collections are simply a collection of pre-built requests that can be organized into folders, and they can be easily exported and shared with others. Below is exported Cargox collection which you can start using immediately.

Please head to https://www.postman.com/downloads/ and download Postman app for your system.

After you install it on your system, download Example Postman collection.

11.1.1. Setting up Postman Collection

Here is a json collection file JSON. You can easily import it into Postman via File->Import command.

The following URLs are available within this Postman Collection. They are already set up in collection.

Sandbox

Endpoint

Base Url

https://app.sandbox.cargox.cc/api/v3/

Access Token Url

https://app.sandbox.cargox.cc/oauth/token/

Postman will import collection and you can try it after setting up OAuth for authentication.

Important

Third-party system requires the client_id and client_secret before using this postman examples.

Please insert client_id and client_secret into collection variables as shown below.

Tip

You can always change the data (like email etc) to your needs. Simply go to collection variables and change it.

../_images/postman1.png

11.1.2. Oauth Authorization

Now we can start using this postman collection. First, we obtain new Oauth Access token. Go to authorization tab and click "Get New Access Token". If client_id and client_secret is set properly set up, we should obtain new access token. Please click "Proceed" and "Use Token".

../_images/access_token.png

Tip

This authorization method will be used for every request in this collection - this token will be automatically added to request headers of every call. If access token expires, repeat this steps to obtain a new one.

../_images/proceed.png ../_images/use_token.png