api2:adaptive:objective_students
====== Differences ====== This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
api2:adaptive:objective_students [2017/10/16 11:22] maries |
api2:adaptive:objective_students [2018/07/23 10:21] (current) maries |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| ===Object resources=== | ===Object resources=== | ||
| ^ Property ^ Type ^ Description ^ | ^ Property ^ Type ^ Description ^ | ||
| + | | id | Integer | identifier for the database of Domoscio's API | | ||
| | reached | Boolean | Did the student went through the objective successfully? | | | reached | Boolean | Did the student went through the objective successfully? | | ||
| | objective_id | Integer | Objective assigned | | | objective_id | Integer | Objective assigned | | ||
| Line 9: | Line 10: | ||
| | adaptive | Integer | 1 if it has to be learned, 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? | | | 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)=== | ===Create (POST)=== | ||
| Line 18: | Line 25: | ||
| ^ Property ^ Type ^ Description ^ | ^ Property ^ Type ^ Description ^ | ||
| - | | objective_id* | Integer | Objective assigned | | + | | objective_id or objective_uid* | Integer | Objective assigned | |
| - | | student_id* | Integer | Student who is assigned an objective | | + | | student_id or student_uid* | Integer | Student who is assigned an objective | |
| | memorize* | Boolean | TRUE if it has to be memorized, FALSE otherwise | | | memorize* | Boolean | TRUE if it has to be memorized, FALSE otherwise | | ||
| | adaptive* | Boolean| TRUE if it has to be learned, 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? | | | 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 | | ||
| ==Send the request (JSON input example)== | ==Send the request (JSON input example)== | ||
| Line 28: | Line 38: | ||
| <code> | <code> | ||
| { | { | ||
| - | objective_id: 1, | + | "objective_id": 319, |
| - | student_id: 1 | + | "student_id": 379, |
| - | memorize: TRUE, | + | "deadline": "2019-06-25", |
| - | adaptive: TRUE, | + | "memorize": true, |
| - | deadline: 2017-06-25 08:00:00 | + | "adaptive": true, |
| + | "required_score": 0.8 | ||
| } | } | ||
| </code> | </code> | ||
| Line 40: | Line 51: | ||
| <code> | <code> | ||
| { | { | ||
| - | id: 1, | + | "id": 293, |
| - | instance_id: 1, | + | "reached": false, |
| - | objective_id: 1, | + | "created_at": "2017-11-27T17:10:26.984Z", |
| - | student_id: 1 | + | "updated_at": "2017-11-27T17:10:26.984Z", |
| - | memorize: TRUE, | + | "objective_id": 319, |
| - | adaptive: TRUE, | + | "student_id": 379, |
| - | deadline: 2017-06-25 08:00:00, | + | "memorize": true, |
| - | reached: false | + | "deadline": "2019-06-25", |
| + | "adaptive": true, | ||
| + | "required_score": 0.8, | ||
| + | "mastery_percentage": null, | ||
| + | "knowledge_node_strategy": null, | ||
| + | "content_strategy": null | ||
| } | } | ||
| </code> | </code> | ||
| Line 61: | Line 77: | ||
| <code> | <code> | ||
| { | { | ||
| - | objective_id: 1, | + | "student_id": 379 |
| - | student_id: 1 | + | |
| } | } | ||
| </code> | </code> | ||
| Line 68: | Line 83: | ||
| ==Get the response (JSON output example)== | ==Get the response (JSON output example)== | ||
| + | |||
| + | **With id provided** | ||
| <code> | <code> | ||
| { | { | ||
| - | id: 1, | + | "id": 293, |
| - | instance_id: 1, | + | "reached": false, |
| - | objective_id: 1, | + | "created_at": "2017-11-27T17:10:26.984Z", |
| - | student_id: 1 | + | "updated_at": "2017-11-27T17:10:26.984Z", |
| - | memorize: TRUE, | + | "objective_id": 319, |
| - | adaptive: TRUE, | + | "student_id": 379, |
| - | deadline: 2017-06-25 08:00:00, | + | "instance_id": 45, |
| - | reached: false | + | "memorize": true, |
| + | "deadline": "2019-06-25", | ||
| + | "adaptive": true, | ||
| + | "required_score": 0.8, | ||
| + | "mastery_percentage": null, | ||
| + | "knowledge_node_strategy": null, | ||
| + | "content_strategy": null | ||
| } | } | ||
| + | </code> | ||
| + | |||
| + | **Without id provided** | ||
| + | |||
| + | <code> | ||
| + | [ | ||
| + | { | ||
| + | "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 | ||
| + | } | ||
| + | ] | ||
| </code> | </code> | ||
api2/adaptive/objective_students.1508145755.txt.gz · Last modified: 2017/10/16 11:22 by maries
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
