设备管理
设备管理
绑定、解绑、查询、在离线、维护与托管相关 HTTP 接口。参数与报文以各接口页为准。
设备添加
| 接口 | 说明 |
|---|---|
| bindDevice：绑定设备 | 设备绑定 |
| unBindDevice：解绑设备 | 设备解绑 |
能力说明与绑定流程见 设备接入。移动端部分机型需结合客户端 SDK 完成绑定，见 应用开发。
设备查询
| 接口 | 说明 |
|---|---|
| 按 ID 批量详情 device.detail.list | 1–50 台序列号批量查询 |
| 分页详情 device.detail.page | 分页查询，含 capabilityIds |
| 查询在离线 device.status.get | 在离线状态 |
| 绑定前信息 device.prebind.get | 未绑定设备信息 |
| 是否已绑定 device.bindstate.get | 绑定关系 |
| 获取局域网信息 device.network.get | 连接与局域网信息 |
Legacy 批量：
listDeviceDetailsByIds/listDeviceDetailsByPage单次 ≤32 台；V2 按 ID 批量详情 1–50 台。Legacy 绑定查询 ↔
device.bindstate.get/device.prebind.get（见 设备管理说明 与各方法页）。Legacy 绑定/查询/升级进度等 OpenAPI 见 遗留 · 设备查询（URL 仍为
/api/{method}/）。
聚合说明页：设备管理说明、按 ID 批量详情、分页详情、查询在离线、获取局域网信息、绑定前信息、是否已绑定。
设备维护
新接入优先 V2 / 能力（见 设备配置与操作 各节）。Legacy modifyDeviceName 等见 遗留 · 设备维护。
设备托管
终端用户将乐橙 App 下设备权限托管给开发者账号。流程、权限码、托管事件报文与「各权限可操作的接口」见 接收终端用户托管的设备。店铺类场景见 SaaS 平台接入终端用户设备。
| 接口 | 说明 |
|---|---|
| deviceListByAuthStatus：分页获取指定状态的托管设备列表 | 按 init / accept / refuse 分页查询 |
| setDeviceAuthStatus：批量设置设备的托管状态 | 接受或拒绝托管申请 |
| authorizedDeviceList：分页获取已托管的设备详情 | 已托管设备详情 |
托管相关推送（warrantInit 等）的报文示例与字段说明见 接收终端用户托管的设备 · 托管事件。是否在报警回调地址接收，以 配置平台消息推送 为准。