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