3. 修改设备

描述:

修改一或多台已经被当前用户绑定的设备信息。

请求说明:

协议 方法 PATH
HTTPS PUT /openApi/device/updateDevices

Body参数:

参数 类型 必填 说明
appId String appId
expires String 过期时间
sign String 签名
deviceNo String 空字符串,固定值:””
cmd String 固定值:updateDevices
data String 设备数组字符串
- devices Array 设备信息数组
- - groupNo int 分组编号
- - deviceNo String 设备编号
- - deviceName String 设备名称
- - remark String 备注
- - deviceAccount String 远程控制账号(车牌相机、道闸识别机可修改此参数)
- - devicePassword String 远程控制密码(车牌相机、道闸识别机可修改此参数)

返回参数:

同绑定设备返回结构。

请求示例:

{"appId":"ym3b7f242fc0814489","expires":"1739583239","deviceNo":"","sign":"36f392b389e945b5c7ca8baa36fae53b","cmd":"updateDevices","data":"{\"devices\":\"[{\\\"deviceNo\\\":\\\"12345678-87654321\\\",\\\"groupNo\\\":150,\\\"deviceName\\\":\\\"\\\",\\\"remark\\\":\\\"\\\",\\\"deviceAccount\\\":\\\"admin\\\",\\\"devicePassword\\\":\\\"admin\\\"},{\\\"deviceNo\\\":\\\"123456789-987654321\\\",\\\"groupNo\\\":151,\\\"deviceName\\\":\\\"\\\",\\\"remark\\\":\\\"\\\",\\\"deviceAccount\\\":\\\"\\\",\\\"devicePassword\\\":\\\"\\\"}]\"}"}

返回示例:

{
  "code":0,
  "msg":"操作成功",
  "appId":"ym3b7f242fc0814489",
  "expires":"1767601245",
  "sign":"30c9a3cd183567250f924707406fd7bf",
  "deviceNo":"",
  "cmd":"updateDevices",
  "data": "{\"successes\":\"[{\\\"deviceNo\\\":\\\"12345678-87654321\\\",\\\"groupNo\\\":150}]\",\"failures\":\"[{\\\"deviceNo\\\":\\\"123456789-987654321\\\",\\\"groupNo\\\":151,\\\"error\\\":{\\\"code\\\":1015,\\\"message\\\":\\\"设备分组不存在\\\"}}]\"}"
}
作者:yrh  创建时间:2026-06-05 14:48
最后编辑:yrh  更新时间:2026-06-05 14:52