EchoVideo's REST API integration essentially provides EchoVideo with an "LMS / VLE course lookup by Instructor" capability. This integration provides two features:

1. 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.
2. 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:

1. Create a Developer Key in Canvas.
2. Copy the ID and Secret values from Canvas to EchoVideo.
3. Authorize the configuration.
4. Test the configuration.
5. Optionally, set Scope restrictions to the Canvas Developer Key.

As with most LMS-to-EchoVideo configurations, you must be logged into 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 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

1. Log into Canvas as an administrator and click Admin from the left navigation, then select the main Account level.
2. From the left side of the page, select Developer Keys, identified in the below figure.
3. Click the Add Developer Key button from the top right of the page, and select API Key from the options given.
   
4. In the Key Settings page, shown below, ensure that Enforce Scopes is turned OFF. If you are using scope restrictions as discussed at the bottom of this page, those must be enabled AFTER the initial configuration and authorization.
5. Enter a Key Name that identifies its purpose.
6. Enter your Email address, identifying who created the key.
7. In the Redirect URI field, enter the following, also shown in the following figure:
   https://echo360.org/lms/api/oauth2/complete
   NOTE: As with most tooling, replace the base domain with your region-specific EchoVideo domain as necessary.
   
8. 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.
9. Click Save.
   When the list of Developer Keys appears, your new key is listed at the top.
10. On the right side of the new key row, toggle the key ON to use it. It is OFF by default.
    
11. If you haven't already, open a new browser tab or window for EchoVideo and log in as an administrator.
12. Click the Settings icon in the upper-right corner of the screen.
13. From the Settings menu, select Institution Settings.

    General settings appears and Basic Info is selected by default.

14. Click Integration.
15. From the middle panel, select LMS / VLE.

    The LTI 1.1 tab is selected by default.

16. Click the API tab.
    
17. 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.
18. Click Add Configuration as shown in the figure above.
19. In the form that appears, shown below, enter a Name for the configuration.
20. Enter your Canvas Domain (base URL of your Canvas instance).
    
21. 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.
    
22. Return to EchoVideo and paste the value (ctrl + v / cmd + v) into the LMS API Client ID field of the API Configuration modal.
23. Return to Canvas and click Show Key to expose the Key secret, then select and copy the secret.
24. Return to EchoVideo and paste the key secret value into the LMS API Client Secret field of the API Configuration modal.
25. Click Save.
26. In the API tab that appears with your new configuration, click Authorize as shown in the figure below.
    
27. In the popup that appears, you may need to log into Canvas as an administrator unless you are already logged in through this browser.
28. When prompted, click Authorize in the Canvas window, to allow the key to access your Canvas account.
    After authorization, the popup closes and the API tab appears again.
29. Click Test to ensure the configuration and communication works properly.
    
30. In the popup that appears, enter an email address for a Canvas instructor known to have courses, then click Search.
    

    NOTE: If the instructor is enrolled in a Canvas course via the UI, the instructor must actively Accept the invitation to the course before the course will appear in the search results. If using an SIS or other integration tool, the "accept" step is not necessary. See the Canvas Community Forum for more information if needed.

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 using 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, to access their LMS-course related media data.

Required Scopes for EchoVideo API Integration

If you need to enforce scopes for your API keys, as many do, you must enable the scopes listed below in the Key Settings for the Developer Key you created for EchoVideo.

This list will change as we expand the use of API integration. For future features, enabling additional scopes may be required. When the scopes change in Canvas, you must recreate the API integration.

• Under Courses, enable:
  • url:GET|/api/v1/users/:user_id/courses
  • url:GET|/api/v1/accounts/:account_id/courses
• Under Users, enable:
  • url:GET|/api/v1/accounts/:account_id/users
  • url:GET|/api/v1/users/:id
• Under Enrollments, enable url:GET|/api/v1/courses/:course_id/enrollments

You must configure the initial API setup without enforcing scopes. Then, as the above procedure states, authorize and test the configuration with EchoVideo. After you have confirmed communication between the two systems, you can enable Enforce Scopes, select the required scopes, and save.

Once you have enabled the appropriate scopes, retest the integration using the last few steps above to ensure that it is still working as expected. If you have problems or questions, please contact your customer success representative or email support@echo360.com.