Retrieve Data by Sensor
Returns stored device data for one sensor of a device
Path: cs-ws/resources/retrieval/sensor Method: GET
Parameters
- apikey
- device_name
- sensor_name
- from ... timestamp as yyyy-mm-dd hh:hh:ss.SSS
- to ... timestamp as yyyy-mm-dd hh:hh:ss.SSS
- direction ...=asc|desc: controls whether timestamped data are retrieved in ascending or descending order, ascending is default
- count ...=true: retrieves only the number of retrieved moments, not the moments themselves
- limit ...=nnn: only up to nnn moments are retrieved. If a limit is reached for a moment series the response contains an element <next_timestamp> which can be used in a continuation of the retrieval for this time series</next_timestamp>
- rollupLength: the length of the rollup interval in minutes, default is 0 meaning no rollup performed
- rollupOp: the operation to performed, one of AVG | SUM | MIN | MAX, default is AVG
Errors:
- 401 UNAUTHORIZED if key is invalid
- 404 NOT FOUND if the device or sensor is not found
Example
GET http://localhost/cs-ws/resources/retrieval/sensor?direction=asc&count=false&
to=2012-09-01%2001%3A00%3A00.000&from=2012-08-31%2001%3A00%3A00.000
&device_name=TempDev2&limit=-1&apikey=1234&sensor_name=TemperatureSensor HTTP/1.1
HTTP/1.1 200 OK
<sensor>
<attribute>
<moment>
<timestamp>2012-08-31 19:55:54.036</timestamp>
<value>1.1</value>
</moment>
<moment>
<timestamp>2012-08-31 19:58:54.036</timestamp>
<value>1.1</value>
</moment>
<name>Temperature</name>
<result>
<count>2</count>
<limit_reached>false</limit_reached>
<next_timestamp/>
</result>
</attribute>
<name>TemperatureSensor</name>
</sensor>