====== Differences ====== This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
api2:knowledge_structure:knowledge_graph [2017/10/07 14:46] 127.0.0.1 external edit |
api2:knowledge_structure:knowledge_graph [2017/11/22 16:09] (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. | ||
+ | |||
+ | {{:api2:knowledge_structure:graph.jpg?400|graph}} | ||
+ | |||
+ | ===Object resources=== | ||
+ | ^ Property ^ Type ^ Description ^ | ||
+ | | id | Integer | identifier for the database of Domoscio's API | | ||
+ | | name | String | Custom data | | ||
+ | | 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_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> | ||
+ | { | ||
+ | "name": "Corporate Finance", | ||
+ | "id": 856, | ||
+ | "created_at": "2017-11-22T15:01:23.263Z", | ||
+ | "updated_at": "2017-11-22T15:01:23.263Z" | ||
+ | } | ||
+ | </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": 856, | ||
+ | "name": "Corporate Finance", | ||
+ | "created_at": "2017-11-22T15:01:23.263Z", | ||
+ | "updated_at": "2017-11-22T15:01:23.263Z" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | |||
+ | **Without ID provided**\\ | ||
+ | <code> | ||
+ | [ | ||
+ | { | ||
+ | "id": 855, | ||
+ | "name": "Assets", | ||
+ | "created_at": "2017-11-20T12:52:35.880Z", | ||
+ | "updated_at": "2017-11-20T12:52:35.880Z" | ||
+ | }, | ||
+ | { | ||
+ | "id": 856, | ||
+ | "name": "Corporate Finance", | ||
+ | "created_at": "2017-11-22T15:01:23.263Z", | ||
+ | "updated_at": "2017-11-22T15:01:23.263Z" | ||
+ | } | ||
+ | ] | ||
+ | </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": 856, | ||
+ | "name": "No more Corporate Finance", | ||
+ | "created_at": "2017-11-22T15:01:23.263Z", | ||
+ | "updated_at": "2017-11-22T15:04:11.268Z" | ||
+ | } | ||
+ | </code> | ||
+ | |||