The Postman API Client allows you to send requests, inspect the response, and easily debug API requests.
A free download is available for Windows, Mac and Linux: https://www.postman.com/downloads/
Postman allows you to import the API functions directly.
Navigate to the API Documentation site, https://api.metdesk.com/doc and select an API:
Click this link on the page to download the YAML file:
Start Postman and click the Import button:
Either drag and drop the YAML file or click Upload Files and select the file. You will be asked
to confirm the import:
If everything looks OK, click the Import button to continue.
The API will appear under Collections (Postman refers to collections of URLs as Collections):
Click the Request and the main Postman window is updated to show the details:
Each Request needs a URL and to present login credentials to the API. The next steps will configure each of these.
Consult the API Documentation, https://api.metdesk.com/doc/ , for the URL required for each API. You can find this on the API Documentation, look for the Servers dropdown which shows the URL:
We run a “production” for live requests, and a “staging” server for API upgrades/testing purposes.
Now since this Request is for the Locations Endpoint, the full URL to be used is:
https://api.metdesk.com/get/metdesk/cwg/v1/locations
Enter the URL into Postman as follows:
Each Request must be sent using your API key. To do this, click Headers and then complete as follows:
Click the Send button and the bottom half of Postman will now display the results of the Request:
If you prefer to download the data, click the arrow on the Send button and select Send and Download:
Submitting Parameters with your Requests is straightforward, click the Params sub-heading and add the Key (parameter name) and corresponding Value: