power.battery.level (Set battery level property)
power.battery.level: Set battery level property
power.battery.level · device scope · permission Config · catalog rw
What it does
Writes battery level percentage (integration/test use depends on model). Range -100–100, step 1, unit %. Follow device.capability.list; may return DV2003 if not listed.
Request URL
POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/device.property.set
Minimum permission
Administrator: no extra permission on own device. Sub-account: Config. No channelId on device scope.
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
token | String | yes | accessToken |
deviceId | String | yes | Device serial |
productId | String | no | Optional. If sent and it does not match the device model → DV2009 |
properties | Object | yes | key power.battery.level |
Values -100–100, step 1, unit %.
Request example
{
"params": {
"token": "<yourAccessToken>",
"deviceId": "TESTIPC000012345",
"properties": { "power.battery.level": 85 }
}
}