RetrieveByDevice

Retrieve Data by Device

Returns stored device data for all sensors of a device

Path: cs-ws/resources/retrieval/device Method: GET

Parameters

• apikey
• device_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 is not found

Example

GET http://localhost/cs-ws/resources/retrieval/device?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 HTTP/1.1

HTTP/1.1 200 OK
<device>
   <name>TempDev2</name>
   <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>
</device>