RetrieveByDeviceList

Retrieve Data by Device List

Returns stored device data for all sensors of a list of devices

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

Parameters

• apikey
• device_names .. list of device names seperated by ":"
• 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

Errors:

• 401 UNAUTHORIZED if key is invalid
• 404 NOT FOUND if the of the devices is not found

Example

GET http://localhost/cs-ws/resources/retrieval/devicelist?direction=asc&count=false&
to=2012-09-01%2001%3A00%3A00.000&from=2012-08-31%2001%3A00%3A00.000&limit=-1&
apikey=1234&device_names=TempDev2%3ATempDev3 HTTP/1.1

HTTP/1.1 200 OK
<devices>
   <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>
   <device>
      <name>TempDev3</name>
      <sensor>
         <attribute>
            <name>Temperature</name>
            <result>
               <count>0</count>
               <limit_reached>false</limit_reached>
               <next_timestamp/>
            </result>
         </attribute>
         <name>TemperatureSensor</name>
      </sensor>
   </device>
</devices>