简要描述
编辑设备
请求 URL
https://openapi.mp.usr.cn/usrCloud/vn/dev/editDevice
请求方式
POST
用户等级
基础版 企业版 旗舰版
请求参数
名称 |
必选/可选 |
类型 |
位置 |
说明 |
X-Access-Token |
必选 |
String |
Header |
登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时,两小时内可以重复使用,获取详情) |
Content-Type |
必选 |
String |
Header |
消息体的媒体类型,必须为”application/json” |
device |
必选 |
JSONObject |
Body |
设备参数 |
relUserIds |
可选 |
Array |
Body |
关联用户列表 |
tags |
可选 |
JSONArray |
Body |
设备标签 |
请求参数(device)
名称 |
必选/可选 |
类型 |
说明 |
projectId |
必选 |
Integer |
组织 id |
name |
必选 |
String |
设备名称 |
templateId |
必选 |
Integer |
设备模板 id |
deviceId |
必选 |
String |
设备的SN |
type |
必选 |
String |
设备类型 |
pass |
可选 |
String |
设备密码 |
funcCloud |
必选 |
String |
云组态开关 |
funcMonitor |
必选 |
String |
云监测开关 |
isTransProtocol |
必选 |
String |
是否为透传协议设备,0:不是 1:是。此条件与开启云组态互斥 |
positionType |
可选 |
Integer |
定位类型:0不定位 1固定位置 2设备自动定位 |
address |
可选 |
String |
设备定位地址描述 |
position |
可选 |
String |
设备定位经纬度 |
响应参数
名称 |
类型 |
说明 |
info |
String |
提示消息 |
status |
Integer |
返回码 |
返回码说明
返回码 |
说明 |
1604 |
修改失败 |
2004 |
设备修改错误 |
2006 |
设备添加错误 |
2010 |
传入的设备不属于操作用户 |
2014 |
设备不存在 |
2042 |
设备过户失败 |
2044 |
设备密码长度应为8 |
2048 |
设备编号为空 |
2084 |
设备的从机序号重复 |
2085 |
设备的从机地址重复 |
2086 |
设备的从机添加失败 |
2094 |
测试设备不能修改 |
2110 |
请选择设备模板 |
2118 |
设备在第三方云平台删除失败 |
2124 |
设备在第三方云平台已绑定 |
5004 |
权限不足 |
5017 |
参数错误 |
5106 |
参数不完整 |
18002 |
所选设备已经存在其他未完成任务中 |
请求示例
- POST https://openapi.mp.usr.cn/usrCloud/vn/dev/editDevice
- Content-Type: application/json
-
- {
- "relUserIds": [],
- "device": {
- "projectId": 1234,
- "templateId": 1234,
- "deviceId": "00000000000000000003",
- "name": "测试",
- "type": "10",
- "position": "117.02496707,36.68278473",
- "address": "山东省济南市历下区",
- "positionType": 1,
- "funcCloud": 1,
- "funcMonitor": 0,
- "isTransProtocol": 0
- },
- "tags": [
- {
- "id": 1529,
- "deviceNo": "00000000000000000003",
- "tagName": "测试主类别",
- "tagValue": "测试标签1-1"
- }
- ]
- }
响应示例
status: 0,info: ok
- Content-Type: application/json
-
- {
- "info" : "ok",
- "status" : 0
- }