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

{
    scoring: <ScoringResult>
    questions: [{
      id: <string>
      scoring: <ScoringResult>
      interactions: <InteractionResult>[]
   }]
}
<InteractionResult> = {
   id: <string>
   type: <string>
   progress: float
   events: <EventData>[]
   scoring: <ScoringResult>
}

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

<ScoringResult> =
    {
        marksTotal: float
        marksEarned: float
        penalties: {
            hintsRequested: int
            mathErrors: int
            notationErrors: int
        }
    }

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

The results for a single interaction contain the following properties:

events An array containing information for every evaluation or hint.
scoring Only present if a scoring model is defined in Create Session. Contains the calculated marking for this interaction, based on the evaluations and hints.
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 85 1308316
Privacy Policy Eindhoven, the Netherlands
Copyright AlgebraKiT 2018