API

Echo360 provides multiple public APIs for programmatic access to the system:

• Capture API - Used to communicate with capture devices, including the Echo360 Pro, the Echo360 Pod, the legacy SCHD as well as Universal Capture: Classroom installations where necessary.

  The current Capture API is version 3.0.2 The Echo360 Capture API Reference Guide is available in PDF form for download and use. If this link does not work, use the attachments link at the bottom of this page.

• Echo360 API - Used to communicate programmatically with the Echo360 active learning platform, providing the ability to retrieve, create, update, and delete objects such as courses, sections, and schedules.
• Reporting API - The reporting API provides self-service, programmatic access to data that Echo360 has recorded about activity on the platform. This includes data on video views, classroom interaction such as questions and polls, and user engagement. The data included some reports that can be customized, such as limiting the results over a specific time range. The output format can also be specified. See Echo360 Reporting API for more information.
• Capture Intake API - The capture intake API provides users the ability to programmatically upload media directly into Echo360. See Echo360 Capture Intake API for more information.

You are strongly encouraged to use the online Swagger Docs for the Echo360 public API, to familiarize yourself with the available calls. It is fully up to date and provides the model and schema for each call. See Using Swagger Docs UI for API Calls for more information.

IMPORTANT: We implemented "rate limiting" on the API calls to 120/minute because too many calls from a single institution can throttle the system for the entire region. If you are using an API script and your script hits the rate limit, Echo360 will return 429 responses. If you receive 429 responses, implement pause/sleep commands into the script, to meter out the calls to below this limit. You may also need to obtain a new access token in order to resume.
Additionally, any requests sent to endpoints that support paging have a minimum return set of 1, a default return set of 100, and a maximum return set of 150. If you need to parse results sets larger than 150, you will need to make multiple calls to these endpoints.

SDK

Echo360 also provides two different public Software Development Kits (SDKs) to assist with using the Echo360 API. The SDKs can be downloaded as zip files by Admins from the Settings > Downloads page.

Each SDK download has complete interface documentation included zip file along with examples showing how to use every single interface class. The documentation is located in the “Echo360 SDK Documentation” directory of the extracted zip file contents.

• Echo360 Java SDK - The SDK is a simple Java interface to the existing API. Besides the full SDK documentation referenced above, there is also a quick start  readme.txt  file located in the top level of the zip file.
• Echo360 .NET SDK - The SDK is a simple .NET interface to the existing API. There is a link located at the top level of the zip file that launches the documentation. Alternately, you can double-click the  index.htm  file located in the Echo360 SDK Documentation directory, to launch the .NET SDK help.

The example projects provided for the .NET SDK require Visual Studio 2013 and, for security reasons, .NET 4.5.

Use the Attachments link below for downloading the Capture API document. (Return to top)