User Tools

Site Tools


access_via_api

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
access_via_api [2021/03/24 16:13] atolstovaccess_via_api [2022/01/26 10:03] atolstov
Line 1: Line 1:
 +<WRAP center round tip 60%>There is Excel VBA scripts codes example [[example_of_data_access_from_excel_via_api|here]]</WRAP>
 +
 +
 ====== Using API ====== ====== Using API ======
  
Line 26: Line 29:
    
 <WRAP center round important 60%> <WRAP center round important 60%>
-Note that, if you are using another WebHMI as client (via cURL Lua's library), the following line should be removed +Note that, if you are using another WebHMI as client (via [[Lua_API|cURL Lua]]'s library), the following line should be removed 
   Accept-Encoding: gzip, deflate, sdch   Accept-Encoding: gzip, deflate, sdch
 </WRAP> </WRAP>
Line 523: Line 526:
 } }
 </code> </code>
 +==== Register's attributes ====
 ^ Register's attributes: ^^^ ^ Register's attributes: ^^^
 |**id**| int | Unique register id | |**id**| int | Unique register id |
Line 614: Line 617:
 |3|Double Word | |3|Double Word |
 |4|Unix Time | |4|Unix Time |
 +|5|String |
 +
  
 ^Storage formats identifiers:^^ ^Storage formats identifiers:^^
Line 1243: Line 1248:
 |min_val |double |Minimal value of the Y axis| |min_val |double |Minimal value of the Y axis|
 |max_val |double |Maximal value of the Y axis| |max_val |double |Maximal value of the Y axis|
 +
 +===== Alert list =====
 +
 +To get a list of all alerts, you must perform a GET request on the URL like this: http://192.168.1.1/api/alerts.
 +
 +To obtain information about a particular alert, you must perform a following GET request on a URL 'http://192.168.1.1/api/alerts/1' . Here "1" is the ID of the desired alert.
 +
 +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 query for the full graph list:
 +
 +  ***URL:** http://192.168.1.1/api/alerts
 +  ***Method:** GET
 +  *Headers:
 +
 +  Accept: application/json
 +  Content-Type: application/json
 +  Accept-Encoding: gzip, deflate, sdch
 +  X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7
 +
 +Reply example:
 +<code>
 +[
 +    {
 +        "id": "1",
 +        "title": "a1",
 +        "description": "<p>my alert</p>",
 +        "image": "",
 +        "level": "0",
 +        "sound": "0",
 +        "canack": "1",
 +        "dict_id": "",
 +        "condition": "[{\"condition\":\"moreThan\",\"regId\":1,\"min\":\"0\",\"max\":\"\",\"bitNum\":\"\",\"state\":\"\",\"value\":\"\"}]",
 +        "category": "",
 +        "group_id": ""
 +    },
 +    {
 +        "id": "2",
 +        "title": "a2",
 +        "description": "<p>my alert</p>",
 +        "image": "",
 +        "level": "0",
 +        "sound": "0",
 +        "canack": "1",
 +        "dict_id": "",
 +        "condition": "[{\"condition\":\"moreThan\",\"regId\":1,\"min\":\"0\",\"max\":\"\",\"bitNum\":\"\",\"state\":\"\",\"value\":\"\"}]",
 +        "category": "",
 +        "group_id": ""
 +    }
 +]
 +</code>
 +
 +<WRAP center round info 60%>
 +To get information about currently active alerts, you can use [[current_alerts?s[]=getcurrentalerts |GetCurrentAlerts]] function and copying its output to some register (and then use GET method for current register's values). 
 +</WRAP>
 +
 +
  
 ===== Image list ===== ===== Image list =====
Line 2265: Line 2334:
 The %%//%% are comments, they are absent in the real reponse.  The %%//%% are comments, they are absent in the real reponse. 
  
 +====== API usage examples ======
 +
 +    * [[example_of_data_access_from_excel_via_api|Data access from Excel]]
 +    * [[example_of_data_access_from_c_c|Data access from C/C++]]
 +    * [[google_sheet_api_example|Data access from the Google Sheets]]
 +    * [[Android demo application]]
 +    * [[Android application via Chrome]]
  
  
access_via_api.txt · Last modified: 2023/03/02 10:53 by emozolyak

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki