Web Service API

 

AContent Web Service API

Access AContent from remote applications through its web service API. This is version 0.1, dated Jun 2010.

AContent provides a search API that allows users to send search requests to AContent. AContent returns results in REST format. AContent also has an OAuth web service API for viewing, downloading, importing and exporting content from remote applications.

Table of Contents

View course URL

http://atutor.ca/acontent/demo/home/course/index.php?_course_id=10

_course_id is the "courseID" element returned in the REST search result

This URL leads to the first content page of the lesson.

Download course URL

http://atutor.ca/acontent/demo/home/imscc/ims_export.php?course_id=10

course_id is the "courseID" element returned in the REST search result

This URL returns a zipped common cartridge of the lesson.

Import common cartridge or content package into AContent

An AContent user ID with author privilege is required for this action. If you don't have an AContent ID yet, register.

After an AContent user ID has been created, the first step is to go through the OAuth authentication process to get an OAuth access token. The authentication process prompts users to login with an AContent user ID, after which an access token is returned. This access token must be sent along with the import request as a user privilege check. The access token can be used repeatedly until its expiration. After the user is confirmed as an valid author, the common cartridge or content package is retrieved from the request "url" parameter and imported as a new AContent lesson. The ID of the newly-imported lesson is returned at success.

http://atutor.ca/acontent/demo/home/ims/ims_import.php?oauth_token=xxx&url=xxx

oauth_token is the valid access token returned by an AContent OAuth server.
url points to a zip file of a common cartridge or a content package.
Refer to Importing Common Cartridges or Content Packages into AContent via OAuth for detailed request parameters and success/fail responses.