Submit Scores to Line Item
The LTI protocol allows you to submit scores to the LMS grade book through the Assignment and Grades - Scores service. LTIAAS gives you access to this service through the
/api/lineitems/:lineItemID/scores API endpoint.
|API Authentication Method||Supported|
The URL encoded line item ID.
The LTI user ID identifying the recipient of the Score (usually a learner).
Possible values: [
Used to indicate to the tool platform the status of the user towards the activity's completion.
Possible values: [
Used to indicate to the platform the status of the grading process, including allowing to inform when human intervention is needed.
All scoreGiven values MUST be positive number (including 0). scoreMaximum represents the denominator and MUST be present when scoreGiven is present. When scoreGiven is not present or null, this indicates there is presently no score for that user, and the platform should clear any previous score value it may have previously received from the tool and stored for that user and line item.
The platform MUST support scoreGiven higher than scoreMaximum. For example, if the tool passes normalized score, ranging from 0 to 1, the scoreMaximum would be 1. scoreGiven: 1.1 would be a valid score.
A scoreGiven MAY be used to pass actual points value, in which case a value for scoreMaximum would be the maximum points possible for that student. For example, the tool MAY pass scoreGiven: 1, scoreMaximum: 3 instead of scoreGiven: 0.33333, scoreMaximum: 1.
Usually a platform will just re-scale the value to the line item's scoreMaximum. For example, if the line item maximum is 6 in the above example, then it would show 2 points as the given score; accordingly, the result would contain resultScore of 2 and resultMaximum of 6.
The 'scoreMaximum' value MUST be a positive number (not including 0). This field is required if the 'scoreGiven' value is present.
comment is intended to be seen by both the student and the instructors. This specification does not support an history of comments; the platform MUST update its comment with every score update. If a score update does not contain a comment, a blank or null, then the comment value MUST be cleared in the platform if the previously recorded comment was also a comment sent from the tool.
Unauthorized. Please check our guide on Authenticating API requests to learn about how authentication works in the LTIAAS API.
details object required
"description": "Invalid or expired ltik."