IMS Final Release

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

Final Release
Date Issued: 10 September 2015
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

3.1 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".

 

Request Header NameValue
Acceptapplication/vnd.ims.lti.v2.toolconsumerprofile+json
Table 1.  Required HTTP Headers for GET Request

 

Table 2 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.

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. 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.

401 Unauthorized The client did not authenticate properly.
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 2.  Possible responses from a GET method

4. References

[ToolConsumerProfile-media-type]
Stephen Vickers. ToolConsumerProfile JSON Binding in the application/vnd.ims.lti.v2.toolconsumerprofile+json format. IMS Final Release. 10 September 2015.

About this Document

Title: A REST API for ToolConsumerProfile Resources in the application/vnd.ims.lti.v2.toolconsumerprofile+json Format
Editor:Stephen Vickers (IMS Global)
Version: 2.0
Version Date: 10 September 2015
Release: Final Release
Status: IMS Final Release
Purpose: This document is made available for review and comment by the public community at large.

List of Contributors

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

Craig DunkD2LPadraig O'hiceadhaHMH
Viktor HaagD2LCharles SeveranceIMS Global
Brad HumphreyInstructureColin SmytheIMS Global
Greg McFallPearsonMatt StoeltingCengage
Mark McKellIMS GlobalJohn TibbettsVitalsource
Bracken MosbackerLumen LearningClaude VervoortCengage
Lance NeumannBlackboardStephen VickersIMS Global