Getting a List of Datapoints
You can get a list of datapoints on a device or set of devices managed by the IzoT Server with an IzoT REST datapoints resource. You can get all datapoints, datapoints meeting specific search criteria, datapoints on a device, datapoints on a device meeting specific search criteria, datapoints on a device where a particular field contains a specified value, or a single datapoint.
For each datapoint, the IzoT Server returns the following properties:
Property | Description |
|---|---|
id | Unique identifier for the datapoint |
url | Datapoint address |
name | Datapoint name |
value | Current value of the datapoint |
notes | Datapoint comment |
device | Parent device that contains the datapoint |
timestamp | UTC time when the value was last written (updated) |
Optional query parameters are as follows:
Parameter | Description |
|---|---|
ref_type = (url | id) | By default, the url field is an address, but if you change the ref_type, the url field will contain a unique primary key. |
search = {search_text} | Search across several text-related fields for a partial case-insensitive match. Multiple searches may be specified. |
{field_name} = {field_value} | Search the specified field name for an exact case-sensitive match with {field_value}. Multiple matches may be specified. |
Examples
Get all datapoints for device 2:
http://[hostname]/api/devices/2/datapoints/Get all datapoints for all devices on the network:
http://[hostname]/api/datapoints/Get datapoint 3:
http://[hostname]/api/datapoints/3/Get all datapoints that currently have the value equal to off:
http://[hostname]/api/datapoints/?value=off