====== Differences ====== This shows you the differences between two versions of the page.
api1:knowledge_structure:knowledge_graph [2017/10/07 14:57] 127.0.0.1 external edit |
api1:knowledge_structure:knowledge_graph [2017/10/17 10:04] (current) maries |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | The content’s structure is gathered into Knowledge Graphs. A Knowledge Graph is the first object to instantiate while setting up your content on our API. | ||
+ | |||
+ | {{ :api1:knowledge_structure:graph_v1.png?600 |Graph example}} | ||
+ | |||
+ | ===Object resources=== | ||
+ | ^ Property ^ Type ^ Description ^ | ||
+ | | name | String | Custom data | | ||
+ | | id | Integer | The Knowledge Graph identifier | | ||
+ | | instance_id | Integer | The instance the knowledge graph belongs to | | ||
+ | |||
+ | ===Create (POST)=== | ||
+ | |||
+ | ^ Method | POST | | ||
+ | ^ URL | /knowledge_graphs | | ||
+ | |||
+ | ==Parameters (*Requiered parameters)== | ||
+ | |||
+ | ^ Property ^ Type ^ Description ^ | ||
+ | | name | String | Custom data | | ||
+ | |||
+ | ==Send the request (JSON input example)== | ||
+ | |||
+ | <code> | ||
+ | { | ||
+ | name: "Corporate Finance" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ==Get the response (JSON output example)== | ||
+ | |||
+ | <code> | ||
+ | { | ||
+ | id: 1, | ||
+ | name: « Corporate Finance », | ||
+ | instance_id: 1 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ===Fetch (GET)=== | ||
+ | |||
+ | ^ Method | GET| | ||
+ | ^ URL | /knowledge_graphs/{knowledge_graph_id} | | ||
+ | |||
+ | If no knowledge_graph_id is provided it will fetch all the knowledge graphs for your instance. | ||
+ | |||
+ | ==Get the response (JSON output example)== | ||
+ | |||
+ | **With ID provided**\\ | ||
+ | |||
+ | <code> | ||
+ | { | ||
+ | id : 1, | ||
+ | name : "Corporate Finance", | ||
+ | instance_id : 1 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | |||
+ | **Without ID provided**\\ | ||
+ | <code> | ||
+ | [ | ||
+ | { | ||
+ | id: 1, | ||
+ | name: "Corporate Finance", | ||
+ | instance_id: 1 | ||
+ | }, | ||
+ | { | ||
+ | id: 2, | ||
+ | name: "Mathematics", | ||
+ | instance_id: 1 | ||
+ | } | ||
+ | ] | ||
+ | </code> | ||
+ | |||
+ | ===EDIT (PUT)=== | ||
+ | |||
+ | ^ Method | PUT | | ||
+ | ^ URL | /knowledge_graphs/{knowledge_graph_id} | | ||
+ | |||
+ | ==Editable parameters== | ||
+ | |||
+ | ^ Property ^ Type ^ Description/expected values | | ||
+ | | name | String | Custom data (<255 characters) | | ||
+ | |||
+ | ==Send the request (JSON input example)== | ||
+ | |||
+ | <code> | ||
+ | { | ||
+ | name : « No more Corporate Finance » | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ==Get the response (JSON output example)== | ||
+ | |||
+ | <code> | ||
+ | { | ||
+ | id: 1, | ||
+ | name: « No more Corporate Finance », | ||
+ | instance_id: 1 | ||
+ | } | ||
+ | </code> | ||
+ | |||