An Objective Student is created to assign an Objective to a Student.
Object resources
Property | Type | Description |
id | Integer | identifier for the database of Domoscio's API |
reached | Boolean | Did the student went through the objective successfully? |
objective_id | Integer | Objective assigned |
student_id | Integer | Student who is assigned an objective |
memorize | Integer | 1 if it has to be memorized, 0 otherwise |
adaptive | Integer | 1 if it has to be learned, 0 otherwise |
deadline | Timestamp | Does it have to be memorized for a specific deadline? |
created_at | DateTime | Date of creation of the object |
updated_at | DateTime | Last time the object has been modified |
required_score | Float | Score you expect your user to have to validate the objective |
mastery_percentage | Float | Percentage of question you expect your user to answer correctly to validate the objective |
knowledge_node_strategy | String | Indicates the strategy used to choose the best knowledge_node |
content_strategy | String | Indicates the strategy used to choose the best content |
Create (POST)
Method | POST |
URL | /objective_students |
Parameters (*Requiered parameters)
Property | Type | Description |
objective_id or objective_uid* | Integer | Objective assigned |
student_id or student_uid* | Integer | Student who is assigned an objective |
memorize* | Boolean | TRUE if it has to be memorized, FALSE otherwise |
adaptive* | Boolean | TRUE if it has to be learned, FALSE otherwise |
deadline | Timestamp | Does it have to be memorized for a specific deadline? |
knowledge_node_strategy | string | Please consult us to discuss which strategy best fits your needs - use default if null |
content_strategy | string | Please consult us to discuss which strategy best fits your needs - use default if null |
required_score or mastery_percentage* | Float | Learning difficulty of the objective, between 0 and 1 |
{
"objective_id": 319,
"student_id": 379,
"deadline": "2019-06-25",
"memorize": true,
"adaptive": true,
"required_score": 0.8
}
Get the response (JSON output example)
{
"id": 293,
"reached": false,
"created_at": "2017-11-27T17:10:26.984Z",
"updated_at": "2017-11-27T17:10:26.984Z",
"objective_id": 319,
"student_id": 379,
"memorize": true,
"deadline": "2019-06-25",
"adaptive": true,
"required_score": 0.8,
"mastery_percentage": null,
"knowledge_node_strategy": null,
"content_strategy": null
}
Fetch (GET)
Method | GET |
URL | /objective_students/{objective_student_id} |
If no objective_student_id is provided it will fetch all the Objective Students for your instance.
If you do not know the objective_student_id, you can add the parameters objective_id and/or student_id, and send the following request:
{
"student_id": 379
}
Get the response (JSON output example)
With id provided
{
"id": 293,
"reached": false,
"created_at": "2017-11-27T17:10:26.984Z",
"updated_at": "2017-11-27T17:10:26.984Z",
"objective_id": 319,
"student_id": 379,
"instance_id": 45,
"memorize": true,
"deadline": "2019-06-25",
"adaptive": true,
"required_score": 0.8,
"mastery_percentage": null,
"knowledge_node_strategy": null,
"content_strategy": null
}
Without id provided
[
{
"id": 293,
"reached": false,
"created_at": "2017-11-27T17:10:26.984Z",
"updated_at": "2017-11-27T17:10:26.984Z",
"objective_id": 319,
"student_id": 379,
"instance_id": 45,
"memorize": true,
"deadline": "2019-06-25",
"adaptive": true,
"required_score": 0.8,
"mastery_percentage": null,
"knowledge_node_strategy": null,
"content_strategy": null
},
{
"id": 294,
"reached": false,
"created_at": "2017-11-27T17:11:07.286Z",
"updated_at": "2017-11-27T17:11:07.286Z",
"objective_id": 318,
"student_id": 379,
"instance_id": 45,
"memorize": true,
"deadline": "2019-06-25",
"adaptive": true,
"required_score": null,
"mastery_percentage": 0.6,
"knowledge_node_strategy": null,
"content_strategy": null
}
]
Fetch Objective Student by Student (GET)
Method | GET |
URL | /students/{student_id}/objective_students |