{ "openapi": "3.0.3", "info": { "title": "Algebrakit Web Service API", "version": "2.0.0", "x-logo": { "url": "https://public.algebrakit.nl/logo_white.png", "altText": "Algebrakit Logo" }, "description": "This API allows creating and managing exercise sessions, retrieve session information and scores, and lock or unlock sessions.\n" }, "servers": [ { "url": "https://api.algebrakit.com", "description": "Production server (Ireland)" }, { "url": "https://prod.api.sg-1.algebrakit.com", "description": "Production server (Singapore)" } ], "paths": { "/session/create": { "post": { "summary": "Create sessions", "description": "Create new sessions for Algebrakit exercises. Multiple sessions can be created in one call to optimize performance.\nThe response contains a unique session ID for each session. It also offers optimized HTML code which you can insert into your web page. \nThis HTML code includes allows for faster initialization as the web component does not need to retrieve data from the web service.\n", "operationId": "sessionCreate", "requestBody": { "required": true, "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/CreateSessionRequest" }, "examples": { "example1": { "$ref": "#/components/examples/CreateSessionRequestExampleMultiple" } } } } }, "responses": { "200": { "description": "Successful creation of sessions", "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/CreateSessionResponse" }, "examples": { "example1": { "$ref": "#/components/examples/CreateSessionResponseExample" } } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/session/retrieve": { "post": { "summary": "Retrieve sessions", "description": "Returns the same session information produced by /session/create, but for for existing sessions. \nUsed to efficiently render the web components for existing sessions.\n\nNote that restoring an existing exercise can be done without using this endpoint, simply by the `akit-exercise` or `akit-interaction` web components:\n```\n\n```\nThe web component will automatically retrieve all needed information (question type, learning events, etc) from the server. \n\nHowever, this roundtrip impacts page load time, \nespecially if multiple exercises are on the page. The `/session/retrieve` endpoint lets you obtain optimized HTML code for multiple sessions in one call. \nInserting this optimized HTML into the webpage prevents a server roundtrip per exercise and allows the exercises to show instantly.\n", "operationId": "sessionRetrieve", "requestBody": { "required": true, "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/SessionRetrieveRequest" }, "examples": { "example1": { "$ref": "#/components/examples/SessionRetrieveRequestExample" } } } } }, "responses": { "200": { "description": "Successfully obtained session data", "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/SessionRetrieveResponse" }, "examples": { "example1": { "$ref": "#/components/examples/SessionRetrieveResponseExample" } } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/session/score": { "post": { "summary": "Get session scores", "description": "Retrieve results from an exercise session. This endpoint allows you to get the scores and other details of the session.\nYou can optionally lock the session to prevent any further modifications.\n", "operationId": "sessionScore", "requestBody": { "required": true, "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/SessionScoreRequest" }, "examples": { "example1": { "$ref": "#/components/examples/SessionScoreRequestExample" } } } } }, "responses": { "200": { "description": "Request succeeded", "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/SessionScoreResponse" }, "examples": { "example1": { "$ref": "#/components/examples/SessionScoreResponseExample" } } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/sessions/lock": { "post": { "summary": "(Un)lock sessions.", "description": "Lock or unlock exercise sessions. Locked sessions do not allow modifications such as new evaluation events.\nThis functionality is mainly intended for assessments to guarantee nobody changes the results afterward.\n\nThere are two types of lock actions. You can later undo a `LOCK` action with an `UNLOCK` action. A `FINALIZE` action locks a session forever.\n\nYou can lock or unlock a batch of sessions in a single request.\n", "operationId": "sessionLock", "requestBody": { "required": true, "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/SessionLockRequest" }, "examples": { "example1": { "$ref": "#/components/examples/SessionLockRequestExample" } } } } }, "responses": { "200": { "description": "Sessions successfully locked or unlocked", "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/SessionLockResponse" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/session/info": { "post": { "summary": "Retrieve session info", "description": "Retrieve detailed information about a session, including exercise layout, solutions, and scoring results.\nThis endpoint provides human-readable (or AI-readable) information about the session, with enhanced annotation data \nthat includes complete question views with student inputs.\n\nThis endpoint will ultimately replace the `/session/score` endpoint.\n", "operationId": "sessionInfo", "requestBody": { "required": true, "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/SessionInfoRequest" }, "examples": { "example1": { "$ref": "#/components/examples/SessionInfoRequestExample" } } } } }, "responses": { "200": { "description": "Request succeeded", "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/SessionInfoResponse" }, "examples": { "example1": { "$ref": "#/components/examples/SessionInfoResponseExample" } } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/exercise/validate": { "post": { "summary": "Validate exercise", "description": "Checks whether an exercise is valid (i.e., that it runs) and obtains general information.", "operationId": "exerciseValidate", "requestBody": { "required": true, "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/ExerciseValidateRequest" }, "examples": { "example1": { "$ref": "#/components/examples/ExerciseValidateRequestExample" } } } } }, "responses": { "200": { "description": "Request was successful", "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/ExerciseValidateResponse" }, "examples": { "example1": { "$ref": "#/components/examples/ExerciseValidateResponseExample" } } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/exercise/published-info": { "post": { "summary": "Retrieve exercise info", "description": "Retrieve information about the structure, versions, and history of an exercise in Algebrakit's CMS.\n", "operationId": "exerciseInfo", "requestBody": { "required": true, "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/ExerciseInfoRequest" }, "examples": { "example1": { "$ref": "#/components/examples/ExerciseInfoRequestExample" } } } } }, "responses": { "200": { "description": "Information about the structure of the exercise.", "content": { "application/json; charset=utf-8": { "schema": { "$ref": "#/components/schemas/ExerciseInfoResponse" }, "examples": { "example1": { "$ref": "#/components/examples/ExerciseInfoResponseExample" } } } } } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-KEY" } }, "schemas": { "IAK_Exercise": { "type": "object", "properties": { "type": { "type": "string", "const": "AK_Exercise" }, "studentProfile": { "type": "string", "description": "ID of the student profile, which defines school level, language, etc." }, "symbols": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The notation of the mathematical symbol in LaTeX notation. For example, \"x\", \"\\angle A_{1}\", etc." }, "type": { "type": "string", "enum": [ "VARIABLE", "CONSTANT", "FUNCTION", "FREEVARIABLE" ], "description": "The type of the math symbol" }, "synonym": { "description": "An optional synonym for the math symbol. This is required if a symbol has multiple interpretations. E.g. \"m\" can be mass or meter. Defining a synonym allows the exercise author to specify which interpretation to use in the exercise. E.g. \"mMass\" and \"mMeter\"", "type": "string" }, "addToFormulaEditor": { "description": "Whether to add the symbol as a button to the formula editor.", "type": "boolean" }, "notations": { "description": "Alternative notations for the symbol. For example, a line segment \"AB\" can also be written as \"BA\".", "type": "array", "items": { "type": "string" } } }, "required": [ "name", "type" ], "additionalProperties": false }, "description": "List of mathematical symbols (variables, units, functions, etc.) used in the exercise" }, "elements": { "type": "array", "items": { "type": "object", "properties": { "blocks": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "CONTENT" }, "content": { "type": "string", "description": "The content in this block in HTML format and LaTeX notation for math expressions. For example, \"Calculate <latex>x</latex> if <latex>2x + 3 = 7</latex>\"." } }, "required": [ "type", "content" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "INTERACTION" }, "interaction": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "CHOICE", "description": "The question type of this interaction, which is \"CHOICE\" for multiple choice questions." }, "refId": { "description": "An optional reference ID for this interaction. If not provided, a pseudo ID will be generated.", "type": "string" }, "instruction": { "description": "The instruction or question prompt for this interaction", "type": "string" }, "scored": { "description": "Whether this interaction should be scored or not. Defaults to true.", "type": "boolean" }, "hints": { "description": "An optional list of general hints for this interaction. These are hints to get the student started and will be shown before any successful attempt is made.", "type": "array", "items": { "type": "string" } }, "spec": { "type": "object", "properties": { "options": { "type": "array", "items": { "type": "object", "properties": { "content": { "type": "string", "description": "The content of the choice option in HTML format with LaTeX embedded in <latex>...</latex> tags." }, "correct": { "type": "boolean", "description": "If true, this option is correct" } }, "required": [ "content", "correct" ], "additionalProperties": false }, "description": "An array of choice options" }, "shuffle": { "type": "boolean", "description": "If true, the options are shuffled" }, "multipleSelect": { "type": "boolean", "description": "If true, multiple options can be selected" } }, "required": [ "options", "shuffle", "multipleSelect" ], "additionalProperties": false } }, "required": [ "type", "spec" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "FILL_IN_THE_BLANKS", "description": "The question type of this interaction, which is \"FILL_IN_THE_BLANKS\" for fill-in-the-blank questions." }, "refId": { "description": "An optional reference ID for this interaction. If not provided, a pseudo ID will be generated.", "type": "string" }, "instruction": { "description": "The instruction or question prompt for this interaction", "type": "string" }, "scored": { "description": "Whether this interaction should be scored or not. Defaults to true.", "type": "boolean" }, "hints": { "description": "An optional list of general hints for this interaction. These are hints to get the student started and will be shown before any successful attempt is made.", "type": "array", "items": { "type": "string" } }, "content": { "type": "string", "description": "The content string in HTML with optional embedded LaTeX and placeholders in square brackets for fields. E.g. 'Calculate <latex>\\sqrt{x^2}=</latex> <blank id=\"B1\"></blank>.'" }, "blanks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The unique identifier for this blank, used as a placeholder in the content string" }, "size": { "type": "string", "enum": [ "SMALL", "MEDIUM", "LARGE" ], "description": "The size of the blank field" }, "type": { "type": "string", "enum": [ "EXPRESSION", "SELECTION" ], "description": "The type of the blank field" }, "input": { "anyOf": [ { "type": "object", "properties": { "task": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "SIMPLIFY", "description": "Indicates the task is to simplify the given mathematical expression using mathematical and algebraic rules." }, "expression": { "type": "string", "description": "The LaTeX string representing the mathematical expression to simplify." } }, "required": [ "type", "expression" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "SOLVE", "description": "Indicates the task is to solve the given equation or inequality for a specific variable." }, "expression": { "type": "string", "description": "The LaTeX string representing the equation or inequality to solve. For example, \"x^2-4=0\" or \"2x+3>5\"." }, "variable": { "type": "string", "description": "The variable to solve for, e.g. 'x'" }, "domain": { "description": "Optional domain of the solution, written as an inequality, e.g. 'x\\geq 0', '05\"." }, "variable": { "type": "string", "description": "The variable to solve for, e.g. 'x'" }, "domain": { "description": "Optional domain of the solution, written as an inequality, e.g. 'x\\geq 0', '05\"." }, "variable": { "type": "string", "description": "The variable to solve for, e.g. 'x'" }, "domain": { "description": "Optional domain of the solution, written as an inequality, e.g. 'x\\geq 0', '05\"." }, "variable": { "type": "string", "description": "The variable to solve for, e.g. 'x'" }, "domain": { "description": "Optional domain of the solution, written as an inequality, e.g. 'x\\geq 0', '05\"." }, "variable": { "type": "string", "description": "The variable to solve for, e.g. 'x'" }, "domain": { "description": "Optional domain of the solution, written as an inequality, e.g. 'x\\geq 0', '05\"." }, "variable": { "type": "string", "description": "The variable to solve for, e.g. 'x'" }, "domain": { "description": "Optional domain of the solution, written as an inequality, e.g. 'x\\geq 0', '05\"." }, "variable": { "type": "string", "description": "The variable to solve for, e.g. 'x'" }, "domain": { "description": "Optional domain of the solution, written as an inequality, e.g. 'x\\geq 0', '0 tags for mathematical input fields\n- tags for multiple choice options\n- \\boxed{\\color{blue} ...} for inline math expression inputs\n" }, "gapIndex": { "type": "integer", "description": "Index of the gap in a Fill in the Blanks question, starting from 1" }, "row": { "type": "integer", "description": "Row index in a Math Table question, starting from 1" }, "col": { "type": "integer", "description": "Column index in a Math Table question, starting from 1" } } }, "EventResultInfo": { "type": "object", "required": [ "timestamp", "event" ], "properties": { "timestamp": { "type": "integer", "description": "Timestamp of the event in milliseconds since the epoch." }, "event": { "$ref": "#/components/schemas/EventType" }, "exerciseStatus": { "description": "Applies to evaluation events. The status of the students work for this math problem. \n", "$ref": "#/components/schemas/ExerciseStatus" }, "inputStatus": { "description": "Applies to evaluation events. The status of the students work on the current part of this math problem. \n", "$ref": "#/components/schemas/ExerciseStatus" }, "tags": { "type": "array", "description": "References to skill tags for this event, which indicate skills and optional misconceptions. Descriptions of these tags are provided in the `tagDescriptions` property of the session info.", "items": { "$ref": "#/components/schemas/SkillTag" } }, "skillsTodo": { "type": "array", "description": "Estimate of skills needed to finish the derivation in this part. Descriptions of these skill IDs are provided in the `tagDescriptions` property of the session info.", "items": { "type": "string" } }, "annotations": { "type": "array", "description": "Meaningful information about the event. What information is provided depends on the question type.", "items": { "$ref": "#/components/schemas/InfoAnnotation" } } } }, "InteractionResultInfo": { "type": "object", "required": [ "id", "type", "status", "progress", "tags", "events" ], "properties": { "status": { "$ref": "#/components/schemas/ExerciseStatus" }, "progress": { "type": "number", "format": "float", "minimum": 0, "maximum": 1, "description": "Progress in range [0..1]. Note that progress is not the same as marks." }, "scoring": { "$ref": "#/components/schemas/InteractionScoring" }, "tags": { "type": "array", "description": "References to skill tags for this interaction, compiled from errors, hints, completed derivations, and next step from \nincomplete derivations. See the `events`` property to see which event generated what skill tags. \nDescriptions of these tags are provided in the `tagDescriptions`` property of the session info.\n", "items": { "$ref": "#/components/schemas/SkillTag" } }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/EventResultInfo" } } } }, "InteractionInfo": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/ElementItemInfoBase" }, { "type": "object", "required": [ "id", "itemType", "interactionType", "solution", "result" ], "properties": { "id": { "type": "string", "description": "Unique identifier ('ref-id') for this interaction." }, "itemType": { "type": "string", "enum": [ "INTERACTION" ] }, "interactionType": { "$ref": "#/components/schemas/InteractionType" }, "content": { "type": "string", "nullable": true }, "solution": { "type": "string" }, "derivation": { "type": "array", "items": { "$ref": "#/components/schemas/DerivationPart" }, "nullable": true }, "result": { "$ref": "#/components/schemas/InteractionResultInfo" } } } ] }, "TextItemInfo": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/ElementItemInfoBase" }, { "type": "object", "required": [ "itemType", "content" ], "properties": { "itemType": { "type": "string", "enum": [ "TEXT" ] }, "content": { "type": "string", "description": "The content, which can include HTML tags for tables, lists, and other formatting. Mathematical expressions are encoded in latex and wrapped in $ ... $." } } } ] }, "ElementItemInfo": { "type": "object", "required": [ "itemType" ], "discriminator": { "propertyName": "itemType" }, "oneOf": [ { "$ref": "#/components/schemas/InteractionInfo" }, { "$ref": "#/components/schemas/TextItemInfo" } ] }, "ElementInfo": { "type": "object", "description": "An Element is either a question block or a content block.", "properties": { "id": { "type": "string", "description": "Unique identifier ('ref-id') for this element block." }, "type": { "type": "string", "enum": [ "INSTRUCTION", "QUESTION" ], "description": "The type of the element. INSTRUCTION elements have no scorable interactions. QUESTION elements contain one or more scorable interactions." }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/ElementItemInfo" } } } }, "SessionInfoResponse": { "type": "object", "required": [ "elements", "tagDescriptions" ], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/ElementInfo" } }, "tagDescriptions": { "$ref": "#/components/schemas/TagDescriptions" }, "scoring": { "$ref": "#/components/schemas/ScoringResult" } } }, "ExerciseValidateRequest": { "oneOf": [ { "type": "object", "required": [ "exerciseId" ], "properties": { "exerciseId": { "type": "string", "description": "Unique identifier for the session to score." }, "version": { "oneOf": [ { "type": "string" }, { "type": "number" } ], "description": "The published version number of the exercise (number) or 'latest' (default). The latter refers to the current version of the exercise." } } }, { "type": "object", "required": [ "exerciseSpec" ], "properties": { "exerciseSpec": { "oneOf": [ { "$ref": "#/components/schemas/IAK_Exercise" }, { "type": "object", "description": "Legacy exercise specification format (internal format)" } ], "description": "An exercise specification in the AK_Exercise format (recommended) or as obtained from the exercise authoring tool. For the full IAK_Exercise specification, see [Exercise Specification](https://docs.algebrakit.com/pages/315-exercise-specification/).\n" } } } ] }, "ExerciseValidateResponse": { "type": "object", "required": [ "valid" ], "properties": { "success": { "type": "boolean", "description": "Indicates if the request was successful." }, "valid": { "type": "boolean", "description": "If false, this exercise has a problem and is not suitable to create sessions." }, "msg": { "type": "string", "description": "A description of the problem in case the request failed or the exercise is not valid" }, "marks": { "type": "number", "description": "The number of marks for the exercise." }, "random": { "type": "boolean", "description": "Indicates if the exercise is random." }, "interactions": { "type": "object", "description": "Details of interactions (question type) within the exercise.", "additionalProperties": { "$ref": "#/components/schemas/InteractionDescription" } } } }, "ExerciseInfoRequest": { "type": "object", "description": "Request to retrieve information about an exercise.", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The exercise ID." } } }, "ExerciseInfoCommitData": { "type": "object", "description": "Commit data for an exercise.", "properties": { "versionNumber": { "type": "string" }, "commitDate": { "type": "string", "format": "date-time" }, "commitMessage": { "type": "string" }, "authorUsername": { "type": "string" } } }, "ExerciseInfoInteraction": { "type": "object", "description": "Interaction info for an exercise version.", "properties": { "block": { "description": "Describes where the interaction is located.", "type": "string" }, "refId": { "description": "The ID of the interaction in the exercise.", "type": "string" }, "refName": { "description": "The name of the interaction in the exercise editor.", "type": "string" }, "type": { "$ref": "#/components/schemas/InteractionType" } } }, "ExerciseInfoResource": { "type": "object", "description": "Resource info for an exercise version.", "properties": { "refId": { "description": "The ID of the resource in the exercise.", "type": "string" }, "type": { "type": "string" }, "refName": { "description": "The name of the resource in the exercise editor.", "type": "string" } } }, "ExerciseInfoPublishedVersion": { "type": "object", "description": "Published version info for an exercise.", "properties": { "name": { "type": "string" }, "majorVersion": { "oneOf": [ { "type": "integer" }, { "type": "string", "enum": [ "latest" ] } ] }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "contentVersion": { "type": "string" }, "numberOfLevels": { "type": "integer" }, "interactions": { "type": "array", "items": { "$ref": "#/components/schemas/ExerciseInfoInteraction" } }, "resources": { "type": "array", "items": { "$ref": "#/components/schemas/ExerciseInfoResource" } } } }, "ExerciseInfoResponse": { "type": "object", "description": "Information about the structure of the exercise.", "properties": { "commitHistory": { "type": "array", "items": { "$ref": "#/components/schemas/ExerciseInfoCommitData" } }, "id": { "type": "string" }, "publishedVersions": { "type": "array", "items": { "$ref": "#/components/schemas/ExerciseInfoPublishedVersion" } }, "courseName": { "type": "string" }, "type": { "type": "string", "description": "regular exercise, single reference, or arrangement exercise" } } } }, "examples": { "CreateSessionRequestExampleMultiple": { "value": { "exercises": [ { "exerciseId": "fa42e943-8213-41a6-8a91-8c22a929ffe9", "version": "latest" }, { "exerciseId": "0ce4c011-28e3-4423-9429-75ae28e3bc10", "version": "latest" } ], "assessmentMode": true, "scoringModel": "default", "apiVersion": 2 } }, "CreateSessionResponseExample": { "value": [ { "success": true, "sessions": [ { "success": true, "sessionId": "691ddb39-e830-41ae-8f97-8c94dcb6120b", "type": "SINGLE", "solution": false, "marksTotal": 1, "interactions": { "lNzHy": { "type": "MULTISTEP", "marks": 1, "scorable": true } }, "html": "" } ] }, { "success": true, "sessions": [ { "success": true, "sessionId": "62ea6f14-bfcc-42a7-8682-7aff31339e24", "type": "SINGLE", "solution": false, "marksTotal": 1, "interactions": { "mFzbB": { "type": "GEOMETRY", "marks": 1, "scorable": true } }, "html": "" } ] } ] }, "SessionRetrieveRequestExample": { "value": { "sessionIds": [ "77aca88f-e2f4-4daf-ba2e-41008fee1f9a" ] } }, "SessionRetrieveResponseExample": { "value": [ { "success": true, "sessionId": "77aca88f-e2f4-4daf-ba2e-41008fee1f9a", "type": "SINGLE", "solution": false, "marksTotal": 1, "interactions": { "lNzHy": { "type": "MULTISTEP", "marks": 1, "scorable": true } }, "html": "" } ] }, "SessionScoreRequestExample": { "value": { "sessionId": "77aca88f-e2f4-4daf-ba2e-41008fee1f9a", "lockSession": true, "withTags": true, "withEvents": true, "withEventAnnotations": true, "withScoring": true } }, "SessionScoreResponseExample": { "value": { "questions": [ { "id": "Q1", "interactions": [ { "id": "lNzHy", "type": "MULTISTEP", "progress": 0.5, "status": "CORRECT", "events": [ { "timestamp": 1752395844080, "event": "EVALUATE", "annotations": [ { "type": "INPUT_EXPRESSION", "expr": [ { "content": "6p-1=4p+10", "mimeType": "application/x-tex" } ] }, { "type": "ERROR_FEEDBACK", "expr": [ { "mimeType": "application/x-tex", "content": "$$6 p - \\begingroup\\color{darkred}\\begingroup 1\\endgroup\\endgroup=4 p + 10$$", "akit": "DerivationContext[Solve[6 p+Highlight[-1]=4 p+10, p, True],Exact=>True]" } ], "main": [ { "mimeType": "text/plain", "content": "You did not compute the multiplication correctly." } ], "sub": [ { "mimeType": "text/plain", "content": "You did not multiply all terms of " }, { "mimeType": "application/x-tex", "content": "$p - 1$", "akit": "p+-1" }, { "mimeType": "text/plain", "content": " by " }, { "mimeType": "application/x-tex", "content": "$6$", "akit": "6" }, { "mimeType": "text/plain", "content": "." } ] } ], "exerciseStatus": "ERROR", "progress": 0, "inputStatus": "ERROR" }, { "timestamp": 1752395846387, "event": "EVALUATE", "annotations": [ { "type": "INPUT_EXPRESSION", "expr": [ { "content": "6p-6=4p+10", "mimeType": "application/x-tex" } ] } ], "exerciseStatus": "CORRECT", "progress": 0, "inputStatus": "CORRECT" }, { "timestamp": 1752395850393, "event": "HINT", "annotations": [ { "type": "HINT", "main": [ { "mimeType": "text/plain", "content": "Balance method: subtract " }, { "mimeType": "application/x-tex", "content": "$4 p $", "akit": "4 p" }, { "mimeType": "text/plain", "content": " from both sides" } ], "expr": [ { "mimeType": "application/x-tex", "content": "$$\\begingroup\\color{#336699}\\begingroup 6 p \\endgroup\\endgroup- 6=\\begingroup\\color{#336699}\\begingroup 4 p \\endgroup\\endgroup+ 10$$", "akit": "DerivationContext[Highlight[6 p]+-6=Highlight[4 p]+10,Exact=>True]" } ] } ] }, { "timestamp": 1752395852101, "event": "EVALUATE", "annotations": [ { "type": "INPUT_EXPRESSION", "expr": [ { "content": "2p=16", "mimeType": "application/x-tex" } ] } ], "exerciseStatus": "CORRECT", "progress": 0, "inputStatus": "CORRECT" }, { "timestamp": 1752395854898, "event": "EVALUATE", "annotations": [ { "type": "INPUT_EXPRESSION", "expr": [ { "content": "p=\\frac{16}{2}", "mimeType": "application/x-tex" } ] } ], "exerciseStatus": "CORRECT", "progress": 0.5, "inputStatus": "CORRECT" }, { "timestamp": 1752395865482, "event": "HINT", "annotations": [ { "type": "HINT", "main": [ { "mimeType": "text/plain", "content": "Calculate: " }, { "mimeType": "application/x-tex", "content": "$\\frac{16}{2}$", "akit": "16/2" } ], "expr": [ { "mimeType": "application/x-tex", "content": "$$p =\\begingroup\\color{#336699}\\begingroup \\frac{16}{2}\\endgroup\\endgroup$$", "akit": "DerivationContext[Solve[p=Highlight[16/2], p, True],Exact=>True]" } ] } ] } ], "scoring": { "marksEarned": 0, "marksTotal": 1, "penalties": { "marksPenalty": 0, "hintsRequested": 2, "mathErrors": 1 }, "finished": false } } ], "scoring": { "finished": false, "marksTotal": 1, "marksEarned": 0, "penalties": { "marksPenalty": 0, "hintsRequested": 2, "mathErrors": 1 } } } ], "scoring": { "finished": false, "marksEarned": 0, "marksTotal": 1, "penalties": { "marksPenalty": 0, "hintsRequested": 2, "mathErrors": 1 } } } }, "SessionLockRequestExample": { "value": { "action": "LOCK", "sessionIds": [ "77aca88f-e2f4-4daf-ba2e-41008fee1f9a" ] } }, "SessionInfoRequestExample": { "value": { "sessionId": "77aca88f-e2f4-4daf-ba2e-41008fee1f9a", "withDerivations": true, "withTags": true, "withEvents": true, "withEventAnnotations": true, "withScoring": true } }, "SessionInfoResponseExample": { "value": { "success": true, "creationTimestamp": 1752395839, "elements": [ { "id": "Q1", "type": "QUESTION", "items": [ { "itemType": "TEXT", "content": "Solve the equation." }, { "itemType": "TEXT", "content": "$$6\\left ( p - 1\\right ) = 4p + 10$$" }, { "id": "lNzHy", "itemType": "INTERACTION", "interactionType": "MULTISTEP", "result": { "status": "CORRECT", "progress": 0.5, "events": [ { "timestamp": 1752395844080, "event": "EVALUATE", "tags": [ { "id": "ExpandSingleBrackets", "weight": 100, "errors": [ "SkippingTerms" ], "source": "ERROR_FEEDBACK" } ], "annotations": [ { "type": "INPUT", "content": "$6p-1=4p+10$" }, { "type": "ERROR_FEEDBACK", "content": "

You did not expand the parentheses correctly.

You did not multiply all terms of $p - 1$ by $6$ .", "expression": "$6 p - \\begingroup\\color{darkred}\\begingroup 1\\endgroup\\endgroup=4 p + 10$" } ], "exerciseStatus": "ERROR", "progress": 0, "inputStatus": "ERROR" } ], "scoring": { "marksEarned": 0, "marksTotal": 1, "penalties": { "marksPenalty": 0, "hintsRequested": 2, "mathErrors": 1 }, "finished": false } }, "solution": "$$p =8$$", "derivation": [ { "expression": "$$6 \\left(p - 1\\right)=4 p + 10$$" }, { "result": "$$6 p - 6=4 p + 10$$", "skills": [ "ExpandSingleBrackets" ], "description": "Expand the brackets" }, { "result": "$$6 p - 4 p - 6=10$$", "skills": [ "EquationsBalanceMethodArrangeTerms", "EquationsOperationsAdd" ], "description": "Balance method: subtract $4 p $ from both sides" }, { "result": "$$2 p - 6=10$$", "skills": [ "AlgebraAddingLikeTerms" ], "description": "Combine the similar terms" }, { "result": "$$2 p =16$$", "skills": [ "EquationsBalanceMethodArrangeTerms", "EquationsOperationsAdd" ], "description": "Balance method: add $6$ to both sides." }, { "result": "$$p =8$$", "skills": [ "EquationsBalanceMethodDivideCoefficient", "EquationsOperationsMultiply" ], "description": "Divide both sides by $2$" } ] } ] } ], "tagDescriptions": { "ExpandSingleBrackets": { "descr": { "en": "Expanding a single pair of parentheses" }, "stepType": "ALGEBRA", "errors": [ { "id": "SkippingTerms", "type": [ "MISCONCEPTION" ], "descr": { "en": "Not multiplying all terms by the factored constant." } } ] }, "EquationsBalanceMethodArrangeTerms": { "descr": { "en": "Arrange terms with variable to the left and other terms to the right." }, "stepType": "STRATEGY" }, "EquationsOperationsAdd": { "descr": { "en": "Add or subtract terms using the balance method" }, "stepType": "STRATEGY" }, "AlgebraAddingLikeTerms": { "descr": { "en": "Adding like terms" }, "stepType": "ALGEBRA" }, "EquationsBalanceMethodDivideCoefficient": { "descr": { "en": "Divide by the coefficient of the variable to get the solution." }, "stepType": "STRATEGY" }, "EquationsOperationsMultiply": { "descr": { "en": "Multiply or divide an equation using the balance method" }, "stepType": "STRATEGY" } }, "scoring": { "finished": false, "marksEarned": 0, "marksTotal": 1 } } }, "ExerciseValidateRequestExample": { "value": { "exerciseId": "e6cef2b5-b114-4931-ac68-b77289d7c0a3" } }, "ExerciseValidateResponseExample": { "value": { "success": true, "valid": true, "marks": 1, "random": true, "interactions": { "Wp0Hr": { "type": "MULTISTEP", "marks": 1 } } } }, "ExerciseInfoRequestExample": { "value": { "id": "fa42e943-8213-41a6-8a91-8c22a929ffe9" } }, "ExerciseInfoResponseExample": { "value": { "commitHistory": [], "id": "fa42e943-8213-41a6-8a91-8c22a929ffe9", "endpoint": "https://algebrakit.eu", "publishedVersions": [ { "name": "A linear equation", "resources": [], "metadata": { "question-type": "Multistep", "creator": "Algebrakit" }, "contentVersion": "11.0", "numberOfLevels": 0, "interactions": [ { "block": "Question a", "refId": "lNzHy", "type": "MULTISTEP", "refName": "I1" } ], "majorVersion": "latest" } ], "courseName": "AlgebraKiT-demo", "type": "regular exercise" } } } } }