====== Differences ====== This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
api2:knowledge_structure:knowledge_node_student [2017/10/13 12:10] maries |
api2:knowledge_structure:knowledge_node_student [2018/07/23 09:43] (current) maries |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | Once the content’s structure is declared on our API, logical links between Students and Knowledge Nodes are created. We could call that « subscriptions ». But it goes further than that since this link is also the container of all the results, data computations and analysis for the student. A Student is related to all the Knowledge Nodes.\\ | + | Once the content’s structure is declared on our API, logical links between Students and Knowledge Nodes are created. We could call that « subscriptions ». But it goes further than that since this link is also the container of all the results, data computations and analysis for the student. A Student is automatically related to all the Knowledge Nodes.\\ |
| {{ :api2:knowledge_structure:kns.jpg?400 | knowledge_node_students }} | {{ :api2:knowledge_structure:kns.jpg?400 | knowledge_node_students }} | ||
| Line 5: | Line 5: | ||
| ===Object resources=== | ===Object resources=== | ||
| ^ Property ^ Type ^ Description ^ | ^ Property ^ Type ^ Description ^ | ||
| + | | id | Integer | identifier for the database of Domoscio's API | | ||
| | knowledge_node_id | Integer | The knowledge node the knowledge node student belongs to | | | knowledge_node_id | Integer | The knowledge node the knowledge node student belongs to | | ||
| + | | knowledge_node_uid | String | Unique identifier for your database of the knowledge node | | ||
| | student_id | Integer | The student the knowledge node student belongs to | | | student_id | Integer | The student the knowledge node student belongs to | | ||
| + | | student_uid | Integer | Unique identifier for your database of the student | | ||
| | active | Boolean | It becomes false when the reviewing has been done to the end | | | active | Boolean | It becomes false when the reviewing has been done to the end | | ||
| | score | Float | The estimated level of the student | | | score | Float | The estimated level of the student | | ||
| | next_review_at | DateTime | The next reviewing date computed by the engine | | | next_review_at | DateTime | The next reviewing date computed by the engine | | ||
| + | | created_at | DateTime | Date of creation of the object | | ||
| + | | updated_at | DateTime | Last time the object has been modified | | ||
| Line 17: | Line 22: | ||
| ^ URL | /knowledge_node_students/{knowledge_node_student_id} | | ^ URL | /knowledge_node_students/{knowledge_node_student_id} | | ||
| - | If no knowledge_node_student_id is provided it will fetch all the Knowledge Node Students for your instance. | + | If no knowledge_node_student_id is provided it will fetch all the Knowledge Node Students for your instance. You can choose to filter the output by providing the following parameters:\\ |
| + | ^ Property ^ Type ^ Description ^ | ||
| + | | knowledge_node_id | Integer | The knowledge node the knowledge node student belongs to | | ||
| + | | student_id | Integer | The student the knowledge node student belongs to | | ||
| ==Get the response (JSON output example)== | ==Get the response (JSON output example)== | ||
| Line 25: | Line 33: | ||
| <code> | <code> | ||
| { | { | ||
| - | id: 941, | + | "id": 762, |
| - | knowledge_node_id: 36, | + | "knowledge_node_id": 2717, |
| - | student_id: 31, | + | "student_id": 267, |
| - | next_review_at: "2017-10-03 12:24:49", | + | "created_at": null, |
| - | active: true, | + | "updated_at": "2017-09-20T14:35:45.256Z", |
| - | score : 0.332711080472931 | + | "next_review_at": "2017-09-22T14:35:45.252Z", |
| + | "active": true, | ||
| + | "score": 0.875, | ||
| + | "theta": 3, | ||
| + | "knowledge_node_uid": "fin_bank", | ||
| + | "student_uid": "bpraly" | ||
| } | } | ||
| </code> | </code> | ||
| Line 37: | Line 50: | ||
| **Without ID provided**\\ | **Without ID provided**\\ | ||
| <code> | <code> | ||
| - | [{ | + | [ |
| - | id: 941, | + | { |
| - | knowledge_node_id: 36, | + | "id": 759, |
| - | student_id: 31, | + | "knowledge_node_id": 2714, |
| - | next_review_at: "2017-10-03 12:24:49", | + | "student_id": 267, |
| - | active: true, | + | "created_at": "2017-09-15T17:37:45.226Z", |
| - | score : 0.33 | + | "updated_at": "2017-11-20T09:53:09.642Z", |
| - | }, | + | "next_review_at": "2017-11-22T09:53:09.621Z", |
| - | { | + | "active": true, |
| - | id: 945, | + | "score": null, |
| - | knowledge_node_id: 51, | + | "theta": 0, |
| - | student_id: 31, | + | "knowledge_node_uid": "fin_asset", |
| - | next_review_at: "2017-10-09 15:17:14", | + | "student_uid": "bpraly" |
| - | active: true, | + | }, |
| - | score : 0.47 | + | { |
| - | }] | + | "id": 762, |
| + | "knowledge_node_id": 2717, | ||
| + | "student_id": 267, | ||
| + | "created_at": "2017-09-15T17:37:45.226Z", | ||
| + | "updated_at": "2017-09-20T14:35:45.256Z", | ||
| + | "next_review_at": "2017-09-22T14:35:45.252Z", | ||
| + | "active": true, | ||
| + | "score": 0.875, | ||
| + | "theta": 3, | ||
| + | "knowledge_node_uid": "fin_bank", | ||
| + | "student_uid": "bpraly" | ||
| + | } | ||
| + | ] | ||
| </code> | </code> | ||