Echo360 provides two different public APIs for programmatic access to the system:
- Capture & Device API - Used to communicate with capture devices, including the 1G Capture Appliance, the SCHD, and the Echo360 PRO, as well as Classroom Capture installations where necessary.
The current Capture API is version 3.0. The Capture Device API 3.0.1 Reference Guide is available in PDF form for download and use.
- 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.
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.
If you prefer to use a static/printable version of the API documentation, we have generated a static version of the Swagger Docs, which you can download locally for your use. You have three options:
- A bootprint generated HTML file; this is packaged here as a zip file along with the associated main.css file. Extract both to the same directory to make use of the CSS stylesheet for visually rendering the information.
- The bootprint generated HTML file is also available online if you prefer: http://help.echo360.org/StaticAPIDocs.html
- A PDF of the HTML file; it is self-contained as a single file and can be ported or printed as needed.
In both formats, the tags, paths, and JSON objects in the static file are linked throughout, so you can access the associated information quickly. We hope to develop a cleaner and even easier to navigate version of the static Swagger Docs file at some point in the future.
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.
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.