Access with Postman

Setting up access using Postman​

As an alternative to use Swagger, the integration API can be accessed via Postman by importing the swagger definition. Postman is a free of charge tool and can either be downloaded as a standalone tool or you can create a new user (for free) and use it online.

Either way, you will need to do three things before starting using Postman: Importing the REST Mapsindoors Integration API definition, tell postman where to make it's calls and finally set up Autorization for it.

Importing to Postman​

The first thing you need before getting started is importing the Mapsindoors Integration API definition to Postman. First click import, paste this link and click import:

https://integration.mapsindoors.com/swagger/v1/swagger.json

Direct Postman to the API.​

Now a new collection called "Integration API" will be created. Select it and change the Variable "baseUrl" to: https://integration.mapsindoors.com

NOTE: ⚠️ Remember to save changes! click the floppy disk icon.


Setup Postman authorization​

Finally we need to set authorization up for it. Go to the Authorization tab and change "Type" from No Auth to OAuth2. Here select Password Credentials as Grant Type.

Now set the:

• "Access Token URL" to https://auth.mapsindoors.com/connect/token

• "Client ID" to client

• Username to your username used in the CMS.

• Password to your password

• Scope to integration

Click "Get New Access Token" and a postman will log in using your credentials. Be sure to save your changes again by clicking the floppy disk icon.

If you use client credentials you will need to select "Client Credentials" as you Grant type and add your ClientID (Ask us if you don't have one) and you Client Secret like this:

Client Credential Flow example

See the client credentials flow for more details:

Client credentials flow

You should now be able to access your MapsIndoors data in Postman.