Description

Returns the consumption of energy on a specific switch that is active on a specific service location during a specified range of time. The call support different aggregation levels to obtain different levels of details.

Resource URL

https://app1pub.smappee.net/dev/v2/servicelocation/[SERVICELOCATIONID]/switch/[ID]/consumption

HTTP method

GET

HTTP header

Authorization: Bearer [ACCESS_TOKEN]

[ACCESS_TOKEN] being the access token received from the Get token or Refresh token authentication calls.

Parameters

Parameter	Type	Description
SERVICELOCATIONID	Path Parameter	The actual id of an accessible service location (see Get Servicelocations)
ID	Path Parameter	The actual id of a switch that is active at the service location (see Get Servicelocation Info where a switch is called an actuator)
aggregation	Query Parameter	The level of detail and should be one of: 1 to obtain the 5 minute data (most detailed level) 2 to obtain hourly values 3 to obtain daily values 4 to obtain monthly values 5 to obtain quarterly values
from	Query Parameter	The UTC timestamp in milliseconds indicating the beginning of the requested period
to	Query Parameter	The UTC timestamp in milliseconds indicating the end of the requested period

Example

http://app1pub.smappee.net/dev/v2/servicelocation/123/switch/2/consumption?aggregation=1&from=1388534400000&to=1391212800000

Result

{
  "serviceLocationId": 123,
  "sensorId": 1,
  "records": [
    {
      "timestamp": 1388534400000,
      "active": 9.0,
      "reactive": 0.0,
    },
    ...
  ]
}

Versioning

This was introduced in version 2 of the API.

Content

Get Switch Consumption