EchoVideo's REST API integration essentially provides EchoVideo with an LMS / VLE course lookup capability by instructor. This integration provides two features:
- The ability for EchoVideo admins or schedulers to create both EchoVideo sections and connect capture schedules directly to LMS Courses. This is described in Linking an EchoVideo Capture Schedule to an LMS Course.
- The ability for instructors to see and use the consolidated Analytics tab from within EchoVideo, which provides viewing and polling response data in one place for all of their LMS-course-related EchoVideo media.
The basic process for API integration is:
- Create a Developer Key in Canvas.
- Copy the ID and Secret values from Canvas to EchoVideo.
- Authorize the configuration.
- Test the configuration.
- Optionally, set Scope restrictions to the Canvas Developer Key.
As with most LMS-to-EchoVideo configurations, you must be logged in to both EchoVideo and the LMS as an administrator and have both programs open in separate browser windows. You will copy and paste values from one to the other.
Best Practices for Application User Access: The API integration requires a user's Email address. It can be a specific person's email address or an application user account you create for this purpose. The account must have administrator rights in Canvas. This user will lock down the integration if your institution wishes to do so at any point. For this reason, we recommend using an application user instead of an actual user.
To configure API integration between EchoVideo and Canvas
- Log in to Canvas as an administrator and click Admin from the left navigation, then select the main Account level.
- From the left side of the page, select Developer Keys, as shown in the figure below.
- Click + Developer Key from the top right of the page, and select API Key from the options given.
- Enter a Key Name that identifies its purpose.
- Enter the Owner Email, identifying who created the key.
Admins can designate themselves as the owner by entering their email address, or use support@echo360.com if a shared or support-level ownership is preferred.
- Enter the Icon URL
https://echo360.org/assets/images/0a11772a218c58bd62b8c46ab5bf90dc-favicon.png
- In the Redirect URIs field, enter the following, also shown in the following figure:
https://echo360.org/lms/api/oauth2/complete
As with most tooling, replace the base domain with your region-specific EchoVideo domain as necessary.
- Be sure Canvas is selected as the Client Credentials Audience at the bottom of the left side of the form. It is the default setting.
- Turn on Enforce Scopes, as shown in the figure below.
- Turn on the following required API scopes:
- Under Accounts, turn on
url:GET|/api/v1/accounts/:account_id/courses
- Under Courses, turn on
url:GET|/api/v1/users/:user_id/courses
- Under Enrollments, turn on
url:GET|/api/v1/courses/:course_id/enrollments
- Under Users, turn on
url:GET|/api/v1/accounts/:account_id/users
-
url:GET|/api/v1/users/:id
This list will change as we expand the use of API integration. For future features, enabling additional scopes may be required.
- Under Accounts, turn on
- Click Save.
When the list of Developer Keys appears, your new key is listed at the top. - On the right side of the new key row, toggle the key ON to use it. It is OFF by default.
- If you have not already done so, open a new browser tab or window for EchoVideo and log in as an administrator.
- Click Settings from the upper-right corner of the screen.
- From the Settings menu, select Institution Settings.
General settings appears and Basic Info is selected by default.
- Click Integrations.
- From the middle panel, select LMS / VLE.
The LTI 1.3 tab is selected by default.
- Select the API tab.
- Optionally, toggle on Full Course Roster. When on, it provides the full course roster for Consolidated Analytics. This allows Instructors to see who has not yet watched a piece of media or engaged with polling questions in their LMS course, rather than displaying only those users who have.
- Click Add Configuration as shown in the figure above.
- In the form that appears, shown below, enter a Name for the configuration.
- Enter your Canvas Domain (base URL of your Canvas instance).
- Return to the Canvas window with the Developer Keys list still showing, and select and copy (Ctrl + C / Cmd + C) the number shown in the Details column for the key you just created, as identified in the figure below.
- Return to EchoVideo and paste the value (Ctrl + V / Cmd + V) into the LMS API Client ID field of the API Configuration modal.
- Return to Canvas and click Show Key to reveal the Key secret. Then select and copy it.
- Return to EchoVideo and paste the key secret value into the LMS API Client Secret field of the API Configuration modal.
- Click Save.
- In the API tab that appears with your new configuration, click Authorize as shown in the figure below.
In the pop-up that appears, you may need to log in to Canvas as an administrator unless you are already logged in through this browser.
- When prompted, click Authorize in the Canvas window to allow the key to access your Canvas account.
After authorization, the pop-up closes, and the API tab reappears. - Click Test to ensure the configuration and communication work properly.
- In the pop-up that appears, enter an email address for a Canvas instructor known to have courses, then click Search.
If the instructor is enrolled in a Canvas course via the UI, they must actively accept the invitation to the course before it appears in the search results. If using an SIS or other integration tool, the accept step is not necessary. Refer to the Canvas Community Forum for additional information.
If the configuration is successful, the bottom section of the test modal is populated with a list of that instructor's Canvas courses, as shown in the figure below. You can close the dialog box by clicking the X in the top-right corner.
You are done! You can now link your EchoVideo capture schedules to LMS courses. Your instructors will now see an Analytics tab in their main menu navigation, allowing them to access their LMS-course-related media data.
If you have problems or questions, contact your customer success representative or email support@echo360.com.