LTI User Messages Launch

Functional Overview

This function may be used to retrieve Turnitin submissions requested via bulk download. When requests for bulk download are made, Turnitin deposits the files in the users inbox.

LTI User Messages Launch

This function will launch a user into their user messages inbox. The user messages inbox will contain system messages and bulk download request results.

Along with the resource / user identifiers you must include the required oauth parameters. The OAuth parameters are used to sign the request and authenticate the call and a custom_source field to identify the API product the call is being made to.

For each Turnitin resource there is a launch url that the action of the form must point to.

The Turnitin resource launch calls are based on the IMS Basic LTI 1.0 standard.

In order to launch a form to open the user's messages inbox in Turnitin the form action must point to /api/lti/1p0/user/messages as in the example below.

Parameters

Required:

lis_person_sourcedid: //Integer. max size xxx. Contains the User ID of the user making the request.
roles: //string. max size xxx. Contains the role type of the person requesting the messages window.

Example LTI Request - User Messages Launch

<form action="https://sandbox.turnitin.com/api/lti/1p0/user/messages" method="POST" target="_blank" enctype="application/x-www-form-urlencoded">
                <input name="lti_version" value="LTI-1p0" type="hidden" />
                <input name="resource_link_id" value="3507a332-59fd-4d7d-9e41-ad8fb76f7562" type="hidden" />
                <input name="lis_person_sourcedid" value="56789" type="hidden" />
                <input name="custom_source" value="16" type="hidden" />
                <input name="launch_presentation_css_url" value="" type="hidden" />
                <input name="oauth_nonce" value="e58ca7c798b7a9d01901848a826669e4a842e32f" type="hidden" />
                <input name="oauth_timestamp" value="1349449538" type="hidden" />
                <input name="oauth_consumer_key" value="1234" type="hidden" />
                <input name="oauth_signature_method" value="HMAC-SHA1" type="hidden" />
                <input name="oauth_version" value="1.0" type="hidden" />
                <input name="oauth_signature" value="oUEsc4smzq%2FuhG4HxQRip5agdmE%3D" type="hidden" />
                <input type="submit" value="Open Messages" /></form>