====== Differences ====== This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
api2:knowledge_content:knowledge_node_content [2017/10/07 14:49] 127.0.0.1 external edit |
api2:knowledge_content:knowledge_node_content [2018/07/23 09:49] (current) maries |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | A Content deals with one or several Knowledge Nodes. For instance, the question “2 x 3 = ?” only deals with the Knowledge Node “multiplication”, while a book on Geography will deals with many Knowledge Nodes. The Knowledge Node Contents represent that relation.\\ | ||
| + | |||
| + | ===Object resources=== | ||
| + | |||
| + | ^ Property ^ Type ^ Description ^ | ||
| + | | id | Integer | identifier for the database of Domoscio's API | | ||
| + | | knowlede_node_id | Integer | One of the knowledge nodes the content is related to | | ||
| + | | content_id | Integer | The related content | | ||
| + | | importance_degree | Integer | If a content is related to several knowledge nodes, that parameter indicates the relative importance of each; 1 indicates the most important knowledge node. | | ||
| + | | created_at | DateTime | Date of creation of the object | | ||
| + | | updated_at | DateTime | Last time the object has been modified | | ||
| + | |||
| + | ===Create (POST)=== | ||
| + | |||
| + | ^ Method | POST | | ||
| + | ^ URL | /knowledge_node_contents | | ||
| + | |||
| + | ==Parameters (*Requiered parameters)== | ||
| + | |||
| + | ^ Property ^ Type ^ Description ^ | ||
| + | | knowlede_node_id (or knowledge_node_uid)* | Integer | One of the knowledge nodes the content is related to | | ||
| + | | content_id (or content_uid)* | Integer | The related content | | ||
| + | | importance_degree | Integer | If a content is related to several knowledge nodes, that parameter indicates the relative importance of each; 1 indicates the most important knowledge node. | | ||
| + | |||
| + | ==Send the request (JSON input example)== | ||
| + | |||
| + | <code> | ||
| + | { | ||
| + | knowledge_node_id: 3170, | ||
| + | content: 2749, | ||
| + | importance_degree: 1 | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==Get the response (JSON output example)== | ||
| + | |||
| + | <code> | ||
| + | { | ||
| + | "id": 1719, | ||
| + | "knowledge_node_id": 3170, | ||
| + | "content_id": 2749, | ||
| + | "created_at": "2017-11-22T17:02:39.343Z", | ||
| + | "updated_at": "2017-11-22T17:02:39.343Z", | ||
| + | "importance_degree": 1 | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ===Fetch (GET)=== | ||
| + | |||
| + | ^ Method | GET| | ||
| + | ^ URL | /knowledge_node_contents/{knowledge_node_content_id} | | ||
| + | |||
| + | If no knowledge_node_content_id is provided it will fetch all the Knowledge Node Content for your instance. You can choose to filter your request thanks to the following parameters:\\ | ||
| + | ^ Property ^ Type ^ Description ^ | ||
| + | | knowlede_node_id | Integer | One of the knowledge nodes the content is related to | | ||
| + | | content_id | Integer | The related content | | ||
| + | |||
| + | ==Get the response (JSON output example)== | ||
| + | |||
| + | **With ID provided**\\ | ||
| + | |||
| + | <code> | ||
| + | { | ||
| + | "id": 1719, | ||
| + | "knowledge_node_id": 3170, | ||
| + | "content_id": 2749, | ||
| + | "created_at": "2017-11-22T17:02:39.343Z", | ||
| + | "updated_at": "2017-11-22T17:02:39.343Z", | ||
| + | "importance_degree": 1 | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | |||
| + | **Without ID provided**\\ | ||
| + | <code> | ||
| + | [ | ||
| + | { | ||
| + | "id": 1719, | ||
| + | "knowledge_node_id": 3170, | ||
| + | "content_id": 2749, | ||
| + | "created_at": "2017-11-22T17:02:39.343Z", | ||
| + | "updated_at": "2017-11-22T17:02:39.343Z", | ||
| + | "importance_degree": 1, | ||
| + | "instance_id": 45 | ||
| + | } | ||
| + | ] | ||
| + | </code> | ||