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\\\":\\\"设备分组不存在\\\"}}]\"}"
}