编辑设备-设备-有人云

简要描述

编辑设备

请求 URL

https://openapi.mp.usr.cn/usrCloud/V6/cusdevice/editCusdevice

请求方式

POST

请求参数

名称	必选/可选	类型	位置	说明
X-Access-Token	必选	String	Header	登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用，获取详情）
Content-Type	必选	String	Header	消息体的媒体类型，必须为”application/json”
cusdeviceNo	必选	String	Body	设备编号
cusdeviceName	必选	String	Body	设备名称
projectId	必选	Integer	Body	组织ID
deviceNo	可选	String	Body	网关编号
templateId	可选	Integer	Body	模板ID
cusdeviceSlaveRelDTO	可选	JSONArray	Body	设备从机关联信息
description	可选	String	Body	设备描述
tags	可选	String	Body	标签集合只需要传递 tagName，tagValue 字段
address	可选	String	Body	地址
position	可选	String	Body	设备地址坐标
positionType	可选	Integer	Body	定位类型（0：不定位，1:手动定位，2：自动定位）

请求参数（cusdeviceSlaveRelDTO）

名称	必选/可选	类型	说明
slaveId	可选	Integer	设备从机id
slaveName	可选	String	从机名称
slaveAddr	可选	String	从机地址
slaveIp	可选	String	从机ip
slavePort	可选	Integer	从机端口
comIdx	可选	Integer	从机通讯号

请求参数（tags）

名称	必选/可选	类型	说明
tagName	必选	String	标签类别名称，不允许名称重复，例如：“功耗”
tagValue	必选	String	标签类别下的标签值名称,可设置多个,不允许名称重复，例如：“800W”

响应参数

名称	类型	说明
info	String	提示消息
status	Integer	返回码

返回码说明

返回码	说明
0	成功
2014	网关不存在
5004	权限不足
5106	参数不完整
5126	请求太频繁

请求示例

POST https://openapi.mp.usr.cn/usrCloud/V6/cusdevice/editCusdevice
Content-Type: application/json
 
{
    "cusdeviceNo": "0000005842000008",
    "deviceNo": "00005842014003180947",
    "templateId": 95080,
    "cusdeviceSlaveRelDTO": [
        {
            "slaveId": "116382",
            "comIdx": "1",
            "slaveAddr": "13"
        },
        {
            "slaveId": "116636",
            "comIdx": "2",
            "slaveAddr": "134"
        }
    ],
    "description": "",
    "tags": [
        {
            "tagName": "aaa",
            "tagValue": "jkl"
        }
    ],
    "projectId": 172808,
    "cusdeviceName": "未命名_设备名称_82",
    "address": "山东省济南市历下区龙奥南路",
    "position": "117.12639941,36.6565542",
    "positionType": 1
 
}

响应示例

status: 0，info: ok

Content-Type: application/json
 
{
    "status": 0,
    "info": "ok"
}