API - Trend list
Материал из WebHMI Wiki
To get a list of all registers, you must perform a GET request on the URL like this: http://192.168.1.1/api/registers.
To obtain information about a particular register, you must perform a following GET request on a URL 'http://192.168.1.1/api/registers/1' . Here "1" is the ID of the desired register.
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 requesting a list of all trends:
URL: http://192.168.1.1/api/trends
Method: GET
Headers:
Accept: application/json Content-Type: application/json Accept-Encoding: gzip, deflate, sdch X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7
Response reply:
[ { "id": "1", "regsid": "16", "title": "Горелка", "height": "350", "min_val": "0", "max_val": "" }, { "id": "2", "regsid": "11,12,13", "title": "Токи A, B, C", "height": "350", "min_val": "0", "max_val": "1500" } ]
Example of requesting trend #2 information:
URL: http://192.168.1.1/api/trends/2
Method: GET
Headers:
Accept: application/json Content-Type: application/json Accept-Encoding: gzip, deflate, sdch X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7
Response example:
{ "id": "2", "regsid": "11,12,13", "title": "Токи A, B, C", "height": "350", "min_val": "0", "max_val": "1500" }
Trend attributes:
id | int | Unique trend identifier |
title | string | Trend name |
regsid | string | List of registers ids to be displayed on the trend. |
height | int | Trend height in pixels |
min_val | double | Minimal value of the Y axis |
max_val | double | Maximal value of the Y axis |