2. 绑定设备

描述：

绑定一台或多台未被绑定的设备到账号下。

请求说明：

协议 方法 PATH
HTTPS POST /openApi/device/addDevices

Body参数：

参数 类型 必填 说明
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 空字符串，固定值：””
cmd String 是 固定值：addDevices
data String 是 设备信息
- devices Array 是 设备信息数组
- - groupNo int 是 分组编号
- - deviceNo String 是 设备编号
- - typeNo int 是 设备类型，1：车牌相机，2：智助机，3：车道控制器，4：门控相机，5：智能云卡，6：人脸终端，7：网络门禁机，8：汽车充电桩，9：单车充电桩，10：通道闸（网关），11：摩托车控制，12：道闸网关，13：智管云盒，14：智慧屏，15：物业电话机，16：对讲立柱，17：访客机，18：数字道闸，19：屏卡，20：环境相机，21：道闸识别机
- - deviceName String 否 设备名称
- - remark String 否 备注
- - deviceAccount String 否 远程控制账号(绑定相机和道闸时，不能为空)
- - devicePassword String 否 远程控制密码(绑定相机和道闸时，不能为空)

返回参数：

参数 类型 必填 说明
code int 是 响应状态码
msg String 是 响应消息
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 空字符串，固定值：””
cmd String 是 固定值：addDevices
data String 是 响应数据
- successes String 是 绑定成功的设备对象数组字符串
- - deviceNo String 是 设备编号
- - groupNo int 是 分组编号
- failures String 是 绑定失败的设备对象数组字符串
- - deviceNo String 是 设备编号
- - groupNo int 是 分组编号
- - error String 是 错误响应对象字符串
- - - code int 是 错误码
- - - message String 是 错误消息

请求示例：

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

返回示例：

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