Get results

Retrieve all student actions for the given session, including evaluation results. You can use this information for example to calculate a score for the student, based on your own scoring scheme.

Endpoint /session/result

Input

{
   sessionId: <string>
}

Result

Multi-question exercise

{
   type = 'MULTIPART'
   questions: [{
      id: <string>
      interactions: [{
          id:  <string>
          session: <Single Question Exercise Result>
      }]
   }]
}

Single-question exercise

{
   type = 'SINGLE'
   status: <Status>
   progress: float
   events: [<Event Data>]
}

<Event Data> =
    {
      event = 'EVALUATE'
      timestamp: long
      progress: float 
      feedback?: {
        tag: <string>
        description: [<ContentElement>]
      }
      exerciseStatus: <Status>
      inputStatus: <Status> 
    }
 |  {
      event = 'HINT'
      timestamp: long
    }

<Status> = 
   'FINISHED' | 'CORRECT' | 'ERROR' | 'NO_MATCH' | 
   'PARSE_ERROR' | 'TRUE_EXPRESSION' | 'FALSE_EXPRESSION'

Input parameters

sessionId ID of the session

Return value

An exercise can consist of multiple questions (like question a, b, c, etc), where each question can contain multiple interactions. Such an exercise is called a ‘multipart’ exercise and the session result is an object with type='MULTIPART'. The IDs in this result relate to the IDs of the questions and interactions that are assigned in the exercise definition by the exercise author.

The results for a single interaction contain the following properties:

events An array containing information for every evaluation or hint.
status Overall status of the exercise: FINISHED if the question is completed, CORRECT if the question is not yet completed.
progress Indication of what percentage of the exercise was completed.

The results for an evaluation event are:

exerciseStatus Overall status of the exercise: FINISHED if the question is completed, CORRECT if the question is not yet completed.
inputStatus Evaluation class of the student input:
FINISHED The input is accepted as the final answer to the question.
CORRECT The input is a correct intermediate step, but the question is not yet finished.
ERROR The input is incorrect and AlgebraKiT has diagnosed an error.
NO_MATCH AlgebraKiT was not able to relate the input to any solution step for this question. The input is probably false.
PARSE_ERROR The input is not a valid mathematical expression.
TRUE_EXPRESSION The input is a correct expression, such as 2x+3x=5x, but AlgebraKiT was not able to relate the input to any solution step for this question. The student probably made some low-level intermediate step.
FALSE_EXPRESSION The input is incorrect, such as 2+3=6.
progress Indication of what percentage of the exercise was completed.
feedback Applies if inputStatus='ERROR'. Contains a tag that identifies the type of mistake, such as AddDecimalsST0 for a mistake involving the addition of negative decimals.
The description consists of text and math elements and can be transformed into html for display using the frontend call AlgebraKIT.elements2html().
about algebrakit contact us
Contact info@algebrakit.nl
Demo +31 624827648
Privacy Policy Eindhoven, the Netherlands
Copyright AlgebraKiT 2018