Fetch usage data
Last updated on May 18, 2015 10:26
This method allows you to fetch detailed usage information for a device at various resolutions.
id- the ID of the subdevice
data_type- The type of data to fetch, for example 'watts' or 'reported_temperature'
resolution- The required resolution. See below for further information
start_time- The start of the time period to search for data
end_time- The end of the time period to search for data
limit- The maximum number of data points to return, starting with the most recent
It is worth noting that the most recent data point can always be retrieved by setting
resolution to "instant",
end_time to the current time, and
limit to 1.
For the following data types, data is available at 3 resolutions -
daily - each being an average of that period:
To reduce data transfer requirements, an additional resolution of "monthly" is available. Unlike other resolutions, this is aggregated on the server and represents a sum of daily data.
The server will respond with an array of arrays, ordered by date/time with the most recent items first. Within each array item, the first item is a timestamp and the second is the data.