- Device API
- Cloud API
- Application API
- Set up and Account Management
- User notification
- Device types
- Device Activation
- Consumer Mapping
- Post device to consumer mapping
- Update consumers
- Delete consumer
- Set device attributes
- Set device property
- Get device properties
- Delete device property
- Set consumer property
- Get consumer properties
- Delete consumer property
- Create/edit consumer make
- Delete consumer make
- Create/edit consumer model
- Delete consumer model
- Monitoring
- Get devices Info
- Get location current total energy usage
- Get location current power consumption
- Get projection for location
- Get aggregated location energy usage
- Get device current total energy usage
- Get aggregated device level energy usage
- Device instantaneous readings history
- Last N history records
- Get current device parameters
- Get real time device readings
- Control
- Rules
- Analytic Rules
- Compare
- Quiz
- Market
- Analytics and Admin API
- Downloads
- Account
You are here
Device API
Device API - Activation
Activation is the process by which you link a device or sense point to your user account. Before being linked, the server will not interact with the device.
Only the device with the Internet connection needs to be activated. This might be the end-device itself, or it could be a proxy for multiple devices. The activation information for a proxy will be automatically inherited by the devices that connect through it.
To activate, the user needs to capture the device's globally unique device ID, and register the device ID with his account. It can be extremely simple.
The device manufacturer needs to provide the user with a way to easily obtain the globally unique device ID. At a minimum, this could be written text on the outside of the device, but can also be included in the form of a barcode or QR code.
The activation command is then a GET or POST to the URL, sent from the user's mobile phone or web portal:http://developer.peoplepowerco.com/espapi/rest/deviceRegistration/{key}/{location id}/{globally unique device id}?deviceType={device type}
More information on this command can be found in the Application API documentation.
- Key = Obtained by logging into your user account
- Location ID = Obtained by using your key to find your location information
- Globally Unique Device ID = MAC address or UUID
- Device Type = A number given to you by People Power which will uniquely identify your device. Each new device is given a new device type to help render user interfaces properly.