Getting Started with the Canvas API with Python

This script will get you started with interfacing with the Canvas API using Python.

Getting Started

These instructions will get you a copy of the script up and running on your local machine for use with Canvas and your own API tokens. This script makes a request to the Canvas API that displays basic information about your user profile.

Prerequisites

1. Install Python 3.7 or greater.
2. Install Git.

Installation and execution

Not sure how to clone a repo? Check out this helpful guide first!

1. Open command prompt on Mac or command line on Windows.
2. Clone this repo. git clone https://github.com/ubccapico/getting-started-with-the-canvas-api-with-python.git
3. Then cd into the repo. cd getting-started-with-the-canvas-api-with-python
4. Run the installation script. pip install -r requirements.txt (If you see bash: pip: command not found, try using pip3 install -r requirements.txt)
5. Generate Canvas API token and copy it to clipboard.
6. Rename the sample.env file to .env, and add your API token to CANVAS_API_TOKEN={ADD TOKEN HERE}.
7. Run the script. python main.py (If you see bash: python: command not found, try using python3 main.py). This should log your Canvas info.

What to do from here

Try running some other scripts from Capico.

You can also write your own code and run it! Be mindful that the API is running on the production Canvas instance - if you want to run against the Beta or Test instance, change the URL in main.py to https://ubc.test.instructure.com or http://ubc.beta.instructure.com and regenerate your token(s) from the Beta/Test site. Students do not have access to Beta or Test, sorry!

Authors

• Justin Lee https://github.com/justin0022 | [email protected]
• Andrew Gardener https://github.com/andrew-gardener | [email protected]

License

This project is licensed under the GPL 3 License.