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:

Direct Postman to the API.

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

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

![Postman BaseVariable]({{ site.url }}/assets/api/v1/postmanbasevariable.png)

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

  • "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:

See the client credentials flow for more details:

Client credentials flow

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

Last updated