Canvas allows for programmatic access to some pieces of information via the [http://instructure.github.com/canvas-lms/doc/api/ Canvas API]. API calls require authorization, and are made on behalf of an authorized user. The information returned MCLA will be different depending on the user you are representing, their roles and permissionsreplacing its telephone system with Microsoft Teams. We are using OAuth2 for remote services This enables users to allow access to resources (notemake or receive through the following options: we haven't yet completely the typical Oauth-user delegation flow, but have a pre-generation utility that can be used in the mean time), which means that all API calls will need to be over https, and will require an access token as a means of representing the user.
You can see the most up*A Teams-to-date [http://instructureenabled physical desk phone installed in your office.github.com/canvas-lms/doc/api/API documentation on github] (note: this link is to *Through your computer using the most up-to-date API interface, which may or may not be accurate for locally installed instances of CanvasMicrosoft Teams client software. If you are not *Through your cell phone using Canvas Cloud, talk to you site administrator about getting an accurate set of API documentation. Admins, you can generate this documentation by running rake doc:api on the console)Microsoft Teams app.
==Using a Microsoft Teams Desk Phone==
== Obtaining an Access Token ==Each MCLA office is provided a Microsoft Teams-enabled phone. There are two types:------[[File:Vvx400_.jpg|frameless|left|100px]]PolyCom VVX 250 (Single Line Phones)*[https://docs.poly.com/bundle/vvx-ip-ug-current/page/vvx-250-hardware.html Overview of Button Layout]*[https://www.poly.com/content/dam/www/products/support/voice/vvx-business-ip-phones/user/vvx-250-350-450-quick-tips-en.pdf Quick Start Guide]*[ How to Sign In]*[ Voicemail Setup]------
[[ImageFile:approved_integrationsCcx400b.pngjpg|300pxframeless|thumbleft|right|Approved Integrations on the user profile page100px]]PolyCom CCX 400 (Multi Line Phone)*[[Imagehttps:generate_an_access_token//docs.poly.com/bundle/ccx-teams-ug-current/page/poly-ccx-400-business-media-phones-hardware.png|300px|thumb|right|Generating an access token]html Overview of Button Layout]*[[Imagehttps:access_token_details//www.png|300px|thumb|right|Reviewing access token detailspoly.com/content/dam/www/products/support/voice/ccx/archive/ccx-teams-6-2-21-ug.pdf User Guide]*[ How to Sign In]*[ Voicemail Setup]
In a user's profile, there is a section titled, "Approved Integrations"==Using the Microsoft Teams Client (Windows or Mac OS)==<youtube>QInQPa7CGzs</youtube>*[https://support. This is a way for a user microsoft.com/en-us/office/first-things-to create an access token that can be shared with a third party, giving the remote service permission -know-about-calls-in-microsoft-teams-2b883a81-dd15-41bd-a6ba-39deef141027 Using Microsoft Teams to access Canvas resources on behalf of the userMake Calls or Recieve Calls]*[https://support.microsoft. The user can give a name to the external tool for easier identification, set an expiration, com/en-us/office/manage-your-call-settings-in-microsoft-teams-456cb611-3477-496f-b31a-6ab752a7595f#Voicemailsettings Configure Microsoft Teams Call and even revoke access to the API by deleting the token.Voicemail Settingsl]*[[Setup Call Forwarding in Microsoft Teams]]
Once you have a Canvas login you can create one of these access tokens to use for testing your development projects. Copy down the token string. This token must be included as a URL query parameter in any API calls made to Canvas.<div style="clear: right;"></div> == Making API Calls With an Access Token Using the Microsoft Teams App on Cell Phones (Apple IPhone or Andriod)== All API calls must also be made over https. The access token must be included as a URL query parameter in any API calls made to Canvas. For example, the endpoint to grab the user's list of courses is <pre>GET /api/v1/courses.json</pre> If Bob's access token were "token_of_magical_power" then you would call <pre>GET /api/v1/courses.json?access_token=token_of_magical_powers</pre> to retrieve Bob's list of courses. For a detailed example of using the API, check out the *[[http://instructure.github.com/canvas-lms/doc/api/basics.html API basics documentation on githubDownloading Teams App]].
