Install and set up Postman

• To download Postman, go to https://www.postman.com/downloads/ and select the relevant bit version of your OS.

• Click the button to download and the installation file for Postman should start downloading. Locate the installation file (usually in the “Downloads” folder) and double-click on the file and complete the installation setup.

Using Postman with MiX Integrate:

In the following section, we’ll cover the following in Postman and provide an example of each:

• Authentication process (getting a token)
• Using the “GET” method.
• Using the “POST” method.
• Using the “PUT” method.
• Using the “DELETE” method.

Authentication process:

MiX Integrate uses an OAuth 2.0 authorization protocol and thus we need to supply Postman with these details to be able to authenticate, receive a token and make subsequent API requests. To get a token, complete the following steps within Postman upon launching the application:

1. Click on the Authorization tab at the top.
2. Select “OAuth 2.0” as the authentication type.
3. Under Configure new token section enter any token name. 
4. Grant Type, select “Password Credentials”.
5. For Access Token URL, the token URL will need to point to the environment where the MiX Fleet Manager account and client ID and client secret lives. Below is a list of the token URL’s:
   • https://identity.uk.mixtelematics.com/core/connect/token
   • https://identity.za.mixtelematics.com/core/connect/token
   • https://identity.ent.mixtelematics.com/core/connect/token
   • https://identity.us.mixtelematics.com/core/connect/token
   • https://identity.au.mixtelematics.com/core/connect/token
   • https://identity.om.mixtelematics.com/core/connect/token
   • https://identity.alg.mixtelematics.com/core/connect/token
6. Client ID: Details received via mail upon application registration
7. Client Secret: Details received via mail upon application registration
8. Enter your MiX Fleet Manager username in the username field.
9. Enter your MiX Fleet Manager password in the password field. 
10. Scope: offline_access MiX.Integrate
11. Client Authentication: Select “Send as Basic Auth header”
12. Once all the details have been completed, click on “Request Token” (note that the below is just an example with the “Access Token URL” pointing to the “uat” environment):

• On the Manage Access Tokens window that pops up, select Use Token”:

• Your newly generated token will be stored under the Header tab and will be sent with each request being made: (you may need to click the hidden icon as shown below if you cannot see the token)

NOTE: The token will expire within 60 minutes after it was initially generated and will need to be replaced by generating a new token to be able to continue making requests.

You can now use it to make requests to MiX Integrate and get a response with the data asked for.