设备能力模型
设备能力模型
设备绑定后，配置、云台、动检和大多数告警应走 v2 能力（device.property.* / device.service.invoke）。设备列表、在离线、绑定状态等 OpenAPI 在 设备管理 模块。先读 能力使用 里的调用顺序，再打开具体能力叶。
能力目录与标识
device.capability.list 返回分组。每组有一个仅出现在响应里的 capabilityId（例如 detection.motion）。不要把 capabilityId 传给 get/set/invoke，也不要用它查告警。使用列表里的完整 propertyId / serviceId / eventId。
本书没有把名为 targetId 的请求字段写进方法表。方法表未列出之前不要自行添加。
device.capability.list
POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/device.capability.list
- 已绑定设备：传
deviceId。未绑定返回DV2013。 - 绑定前可以用设备详情里的
productId。两个都传时以设备为准；型号不一致返回DV2009。 - 返回列表不会按权限裁剪。
- 只有这份列表里的
propertyId/serviceId才能用于 v2 get/set/invoke。
通道级项需要 channelId（IPC 常见 "0"）。通道调用漏传会返回 DV2007。详见 列举能力。
属性、服务与事件
| 目标 | 方法 | 页面 |
|---|---|---|
| 读属性 | device.property.get | 读属性 |
| 写属性 | device.property.set | 写属性 |
| 一次性动作（云台、抓图） | device.service.invoke | 调用服务 |
| 设备事件 | 回调 capabilityEvent | 设备消息 |
get/set/invoke 主机：POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/{methodName}。请求体：id、system、params。签名与其它 OpenAPI 相同。已绑定设备传 deviceId；productId 可选（型号，与 list 相同校验：传了且与设备实际型号不一致 → DV2009）。
仅发现（discovery-only）的叶子没有 get/set/invoke 示例——不要调用。
旧版 HTTP 接口
部分存量集成仍使用 POST /openapi/{method}。旧版接口 按方法分页说明：新接入应优先用 v2 设备 API 或能力叶；若页面写明可继续旧调用，则仅在该存量客户端上保留。
| 场景 | 新接入从这里开始 |
|---|---|
| 设备列表 / 详情 / 在离线 | 设备管理 中的 V2 查询 |
| 云台、录像计划、告警参数等 | 能力使用 或旧版接口中对应页 |
| 直播、云录像、账号、绑定 | API 参考 当前模块（非旧版区） |
海外不发布旧物模型 OpenAPI
getProductModel、iotDeviceControl 等旧物模型 OpenAPI 未对海外集成发布。请使用 device.property.* 和 device.service.invoke。海外不提供设备托管。依据：设备能力与事件参考。