Differences

This shows you the differences between two versions of the page.

--- access_via_api [2018/12/11 12:04] – [List of dashboard's blocks] emozolyak
+++ access_via_api [2019/03/12 14:45] – akuzmuk
@@ Line 910: / Line 910: @@
 Example of the response:
-<code lua>
+<code>
 {
   "1": {
@@ Line 2107: / Line 2107: @@
 |**regid**|	int |ID of the source register for value |
+===== Managing recipes list =====
+To get a list of all recipes, you must perform a GET request on the URL like this: http://192.168.1.1/api/recipes.
+To obtain information about a particular recipe, you must perform a following GET request on a URL 'http://192.168.1.1/api/recipes/12'. Here "12" is the ID of the desired recipe.
+In the headers, it is necessary to pass API key. For example:
+  X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7
+Also, in the headers, you must specify the desired data exchange format. Currently, only the JSON format is supported.
+  Accept: application/json
+  Content-Type: application/json
+Example of a query for all recipes data:
+  ***URL:** http://192.168.1.1/api/recipes
+  ***Method:** GET
+  *Headers:
+  Accept: application/json
+  Content-Type: application/json
+  Accept-Encoding: gzip, deflate, sdch
+  X-WH-APIKEY:F3C74230818DA487BB2017CE5D0290F4DABCAFD7
+Response example:
+<code>
+[
+  {
+    "id": "2",
+    "title": "Black tea",
+    "category": "",
+    "description": "",
+    "regs_values": "3^50|4^20|5^7",
+    "allowed_for_roles": "1,2,3",
+    "disabled": "0"
+  },
+  {
+    "id": "1",
+    "title": "Green tea",
+    "category": "",
+    "description": "",
+    "regs_values": "3^100|4^10|5^5",
+    "allowed_for_roles": "1,2,3",
+    "disabled": "0"
+  }
+]
+</code>
+^Block attributes:^^^
+|**id**|	int |Unique recipe identifier |
+|**title**|	string |Title of recipe |
+|**category**|	string |Category of recipe |
+|**description**|	string |Description of recipe |
+|**regs_values**|	string |List of register values in following format: reg_id1%%^%%new_value%%|%%reg_id2%%^%%new_value%%|%%reg_id3%%^%%new_value |
+|**allowed_for_roles**|	string |Comma-separated role IDs who can access this recipe |
+|**disabled**|	int |Flag that shows if recipe is disabled |
+To update a register values in particular recipe it's necessary to execute PUT-request on URL  http://192.168.1.1/api/recipes/23. Here 23 - is the ID of the recipe to be modified.
+In the headers, it is necessary to pass API key. For example:
+  X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7
+Also, in the headers, you must specify the desired data exchange format. Currently, only the [[https://ru.wikipedia.org/wiki/JSON |JSON]] format is supported.
+  Accept: application/json
+  Content-Type: application/json
+In the request body, the json-object with at least of property be passed.
+<code>
+{"regs_values":"3^110|4^13|5^5","title": "Recipe for March 21st, 2019"}
+</code>
+Example of updating title and register values to the recipe with ID = 5:
+  ***URL**: http://192.168.1.1/api/recipe/5
+  ***Method**: PUT
+  *Headers:
+  Accept: application/json
+  Content-Type: application/json
+  Accept-Encoding: gzip, deflate, sdch
+  X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7
+Request body:
+{"regs_values":"3^110|4^13|5^5", "title": "Recipe for March 21st, 2019" }
+If the request is valid, API will return HTTP-code 200.