IMS Public Draft
IMS Public Draft

A REST API for ToolConsumerProfile Resources
in the application/vnd.ims.lti.v2.ToolConsumerProfile+json Format

Version 2.0 Public Draft
Date Issued: 9 October 2012
Latest version: http://www.imsglobal.org/lti

Abstract

This specification defines a REST API for reading ToolConsumerProfile resources.

Table of Contents

1. Introduction

This specification defines a REST API for reading ToolConsumerProfile resources via an HTTP GET request.

2. ToolConsumerProfile Representations

ToolConsumerProfile resources manipulated via this REST API are represented as JSON documents in the application/vnd.ims.lti.v2.ToolConsumerProfile+json format. For detailed information about this media type, see [ToolConsumerProfile-media-type].

3. Service Methods

4. GET

To get a representation of a particular ToolConsumerProfile instance, the client submits an HTTP GET request to the item's REST endpoint. To obtain the ToolConsumerProfile based on a particular version of LTI the client appends a query parameter named lti_version where the value of this parameter is the official identifier for the LTI version, e.g. "LTI-2p0".

 

 

Table 1 describes the possible responses from the GET method.

HTTP Status Description
200 OK The request was successful.

The response contains a JSON document in the format defined by the application/vnd.ims.lti.v2.ToolConsumerProfile+json media type.

401 Unauthorized The client did not authenticate properly.
301 Moved Permanently The URI for the requested resource has changed.

In this case, the response body is empty, and the new URI is provided in the Location header field. The client should GET the resource from the new location, and furthermore, it should send all future requests to the new location as well.

307 Temporary Redirect The requested resource resides temporarily under a different URI.

In this case, the response body is empty, and the temporary URI is defined by the Location header field. The client should GET the resource at the temporary URI, but future requests should continue to be sent to the original URI.

404 Not Found The server has not found anything matching the request URI.
500 Internal Service Error The server encountered an unexpected condition which prevented it from fulfilling the request.
Table 1.  Possible responses from a GET method

1. References

[ToolConsumerProfile-media-type]
Stephen Vickers. ToolConsumerProfile JSON Binding in the application/vnd.ims.lti.v2.ToolConsumerProfile+json format. IMS Public Draft. 1 November 2012.

About this Document

Title: A REST API for ToolConsumerProfile Resources in the application/vnd.ims.lti.v2.ToolConsumerProfile+json Format
Co-chairs: Greg McFall (Pearson), Lance Neumann (Blackboard)
Editor:Stephen Vickers (IMS Global)
Version: v1.0
Version Date: 9 October 2012
Release: v2.0
Status: IMS Public Draft
Purpose: This document is made available for review and comment by the public community at large.
Document Location: Join the discussion and post comments on the LTI Public Forum: http://www.imsglobal.org/community/forum/categories.cfm?catid=44

List of Contributors

The following list of individuals contributed to the authoring of this document:

Craig DunkDesire2learnColin SmytheIMS Global
Greg McFallPearsonMatt StoeltingCengage
Mark McKellIMS GlobalJohn TibbettsVitalSource
Lance NeumannBlackboardStephen VickersIMS Global
Charles SeveranceIMS Global

IMS Global Learning Consortium, Inc. (“IMS Global”) is publishing the information contained in this (“Specification”) for purposes of scientific, experimental, and scholarly collaboration only.

IMS Global makes no warranty or representation regarding the accuracy or completeness of the Specification. This material is provided on an “As Is” and “As Available” basis.

The Specification is at all times subject to change and revision without notice.

It is your sole responsibility to evaluate the usefulness, accuracy, and completeness of the Specification as it relates to you.

IMS Global would appreciate receiving your comments and suggestions.

Please contact IMS Global through our website at http://www.imsglobal.org

Please refer to Document Name: IMS Global Learning Tools Interoperability v2.0 Public Draft
Revision: 1 November 2012