This information is really geared towards users who are trying to get started with the API.
I have seen questions in the community about the API, and have see Postman mentioned many times. But, searching the Community I have not found any posts specifically about this tool and feel it might be worth talking about for those looking for a starting point. My hope is that folks who are experienced with the tool can add to this information and further help new users get up to speed.
Postman Web App
Postman is easily accessible in Chrome through the Web Store.
If you haven't installed an app in Chrome before take a look at this article:
To make an API call you will need to use your developer token to authenticate.
The following screen shot illustrates how to use the Headers to submit your token.
Click on the "Headers" tab
Enter the value "Authorization" for the key
Enter "Bearer <token>" as the value
This screen shot also shows an example of the syntax to get a list of enrollments for a specific course, which you might want to use to test your token.
Example of a GET
You will need to tell Postman what type of API call you are making, i.e.GET, POST, PUT, whatever HTTP verb is associated with the API call. The following screen shot shows an example of making a GET call to get the current status of an asynchronous job: Progress - Canvas LMS REST API Documentation
In this case the API call is asking for the status of a content migration request. You can see that GET has been selected as the type of API call being made, the authorization token has been provided, and the json results are displayed.
Example of a POST
This is an example of a POST command to copy course content into another course:
In this example, I am passing a parameter to publish/unpublish a course (which is useful in a script to publish all courses at the beginning of a semester). Notice this time that PUT is selected in Postman.
API results come back in JSON format. JSON is notation representing object data. If you are not familiar with JSON take a look at this W3Schools page for an overview: