Get started
  • English
  • 简体中文
Official Site
Get started
  • English
  • 简体中文
Official Site
  • Get started
  • Concepts
  • Guides
  • Device capabilities & events
    • Browse by device type
    • Device capabilities
      • Common methods
      • Detection and alarms
      • Image
      • PTZ
      • Light
      • Recording
      • Audio
      • Media
      • Network
      • Power
      • Privacy
      • Call
      • Storage
      • System
        • Diagnostics
          • system.diagnostics.loginTime (Read login timestamp update)
          • system.diagnostics.maxOnline (Read maximum online duration)
          • system.diagnostics.state (Read device boot state)
          • system.diagnostics.heartbeat (Heartbeat)
          • system.diagnostics.selfTest (One-tap self-test)
          • system.diagnostics.booted (Device booted)
          • system.diagnostics.rebootState (Read reboot state)
          • system.diagnostics.rebootState (Set reboot state)
        • Information
        • Maintenance
        • Time
        • Upgrade
        • Credentials
      • Algorithm
      • Maintenance
      • Control
    • Events overview
    • Permission codes
    • Capability error codes
    • Alarm and capability messages
    • Capability FAQ
    • Legacy ability and push types
  • API reference
  • SDK and tools
  • Solutions
  • Platform and support
On this page
What it does
Request URL
Minimum permission
Request parameters
Request example
Response data fields
Response example
Error codes

system.diagnostics.rebootState (Read reboot state)

system.diagnostics.rebootState: Read reboot state

system.diagnostics.rebootState · device scope · permission Config

What it does

Read reboot state (rststatus/129000). text enum; common values 0/1/2 (exact set from capability discovery).

Request URL

POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/device.property.get

Minimum permission

The administrator does not need an extra permission on a device they bound. A shared device needs the basic configuration permission. A bound sub-user does not. A sub-account needs Config.

Request parameters

NameTypeRequiredDescription
tokenStringyesAccess token for an administrator, sub-user, or sub-account
deviceIdStringyesDevice serial number
productIdStringnoOptional. If sent and it does not match the device model → DV2009
propertiesArrayyes["system.diagnostics.rebootState"]

For common request fields and signing, see Signing conventions and Common request payload.

Request example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system": {
 "ver": "1.0",
 "appId": "lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time": 1706511734,
 "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
 },
 "params": {
 "token": "<yourAccessToken>",
 "deviceId": "TESTIPC000012345",
 "properties": [
 "system.diagnostics.rebootState"
 ]
 }
}

Response data fields

The value is in result.data.properties["system.diagnostics.rebootState"].

ValueDescription (common catalog levels)
"0"On
"1"Off
"2"Power-loss memory

Some models add extended levels (e.g. "3" custom); see device.capability.list and the device TSL.

Response example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "result": {
 "code": "0",
 "msg": "Operation is successful",
 "data": {
 "properties": {
 "system.diagnostics.rebootState": "1"
 }
 }
 }
}

Error codes

CodeWhen
0Success
SN1001Signature error
TK1002Token invalid or expired
DV2007Wrong or missing channelId for scope
DV2008Device and channel properties mixed in one request
DV2003Property not on this device
DV2004Invalid enum value for rebootState

See Global return codes. All DV20xx: Capability errors.

Set reboot state · Diagnostics

system.diagnostics.booted (Device booted)
system.diagnostics.rebootState (Set reboot state)