使用说明

设备能力

设备已经绑定。改开关、转云台、收告警，都是 POST https://openapi.lechange.cn/openapi/v2/{方法名}。外层是 id、system、params。各页样例里的 id 是同一条请求号，方便对照，不是业务字段。sign 见开发规范。

查这台支持哪些项、读配置、写配置、做动作，用能力使用最前面四页：

做什么	方法名	去哪
查这台或这个型号支持哪些项	`device.capability.list`	查询可用能力
一次读多项配置	`device.property.get`	批量读配置
一次写多项配置	`device.property.set`	批量写配置
转云台、抓图等	`device.service.invoke`	调用一次动作

侦测、云台、灯光等见能力使用。收推送、查历史在告警消息。重启、WiFi、校时、升级、改名在其他能力接口。详情、在离线、绑定在设备管理。

拿管理员、子用户或子账号 accessToken。子账号 token 见获取子账号 Token，授权见添加子账号权限。调用次数见限额与频率。回调地址见推送配置。子账号 / 被分享权限见权限码。失败看 result.code，见错误码。

调用方式（list / v2 / 遗留 OpenAPI / PaaS）

类型	说明
仅发现	只出现在 list，禁止 property/service 调用；见各页「仅发现」说明
公开 v2	`device.property.get/set`、`device.service.invoke` 及查询维护类 v2
遗留 OpenAPI 接口	具名 OpenAPI，与能力 ID 并存时以方法页参数为准
PaaS 私有执行	list 用 ability；执行走平台内 PaaS HTTP，IoT 走 v2

仅发现能力叶：目录中带「仅发现」说明，无 property/service 样例；误调用见各页说明。
公开 v2：本页下方「先跑通一次」及多数能力子页。
遗留 OpenAPI 接口：见从旧接口迁移到设备能力。
PaaS 私有执行：list 见 ability；执行不另开 OpenAPI，IoT 设备走 v2。

先跑通一次

对一台已绑定设备打开动检。需要管理员、子用户或子账号 accessToken 和设备序列号。

通道级要带 channelId（IPC 常见 "0"），漏了返回 DV2007。管理员操作自己绑定的设备不需要权限。操作被分享设备需要基础配置权限。子用户绑定不需要。子账号需要 Config。见权限码。其他能力以各自能力页为准。

1. 看这台设备有没有动检

POST https://openapi.lechange.cn/openapi/v2/device.capability.list

{
  "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",
    "channelId": "0"
  }
}

在 result.data.capabilities 里找到 capabilityId 为 detection.motion 的块，确认有 detection.motion.enabled，且 accessMode 含 w。

2. 获取当前开关

POST https://openapi.lechange.cn/openapi/v2/device.property.get

完整请求见获取移动检测开关属性。

{
  "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",
    "channelId": "0",
    "properties": ["detection.motion.enabled"]
  }
}

成功时 result.code 为 "0"，data.properties["detection.motion.enabled"] 为 0 或 1。

3. 打开开关

POST https://openapi.lechange.cn/openapi/v2/device.property.set

完整请求见设置移动检测开关属性。

{
  "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",
    "channelId": "0",
    "properties": {
      "detection.motion.enabled": 1
    }
  }
}

成功时 result.code 为 "0"，data 为 {}。再获取一次确认值为 1。

要收这条动检告警，见接收告警。灵敏度、区域、时间段见动检。转云台见云台。失败看 result.code：DV2007 补 channelId；DV2011 看权限码；DV2004 核对取值。没有 detection.motion.enabled 见常见问题的 DV2003。更多见常见问题。