header_logo
header_logo

编辑设备

简要描述

  1. 编辑设备

请求 URL

  1. https://openapi.mp.usr.cn/usrCloud/vn/dev/editDevice

请求方式

  1. 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 所选设备已经存在其他未完成任务中

请求示例

  1. POST https://openapi.mp.usr.cn/usrCloud/vn/dev/editDevice
  2. Content-Type: application/json
  3.  
  4. {
  5. "relUserIds": [],
  6. "device": {
  7. "projectId": 1234,
  8. "templateId": 1234,
  9. "deviceId": "00000000000000000003",
  10. "name": "测试",
  11. "type": "10",
  12. "position": "117.02496707,36.68278473",
  13. "address": "山东省济南市历下区",
  14. "positionType": 1,
  15. "funcCloud": 1,
  16. "funcMonitor": 0,
  17. "isTransProtocol": 0
  18. },
  19. "tags": [
  20. {
  21. "id": 1529,
  22. "deviceNo": "00000000000000000003",
  23. "tagName": "测试主类别",
  24. "tagValue": "测试标签1-1"
  25. }
  26. ]
  27. }

响应示例

status: 0,info: ok

  1. Content-Type: application/json
  2.  
  3. {
  4. "info" : "ok",
  5. "status" : 0
  6. }
方案咨询
联系方式