添加设备-设备-有人云

#### 简要描述

添加设备

#### 请求 URL

https://openapi.mp.usr.cn/usrCloud/vn/dev/addDevice

#### 请求方式

POST

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| X-Access-Token | 必选  | String  | Header |  登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用，[获取详情](http://cloud.usr.cn/document/589.html "获取详情")） |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"|
| relUserIds | 可选  | JSONArray  | Body | 关联用户id列表  |
| device | 必选  | JSONObject  | Body | 设备参数  |
| tags | 可选  | JSONArray  | Body | 设备标签  |

**请求参数（device）**

| 名称  | 必选/可选  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| projectId | 必选  | Integer  | 组织 id  |
| templateId | 必选  | Integer  | 设备模板 id  |
| deviceId | 可选  | Integer  | 设备的SN |
| QRcode  | 必选 | String  | 设备 sn+mac/imei <br/> 格式为: "deviceId" : mac/imei, "sn" : sn  <br/>可参考请求参数 |
| name  | 必选  | String  | 设备名称  |
| type  | 必选  | Integer  | 设备类型, 默认10  |
| img  | 可选  | String  | 图片路径  |
| pass  | 可选  | String  | 设备密码  |
| position  | 可选  | String  | 设备定位经纬度  |
| address  | 可选  | String  | 设备定位地址描述  |
| positionType  | 可选  | Integer  | 定位类型：0不定位 1固定位置 2设备自动定位  |
| funcCloud  | 必选  | String  | 云组态开关  |
| funcMonitor  | 必选  | String  | 云监测开关  |
| isTransProtocol  | 必选  | String  | 是否为透传协议设备，0：不是 1：是  |

**请求参数（tags）**

| 名称  | 必选/可选  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| tagName | 必选  | String  | 标签类别名称  |
| tagValue | 必选  | String  | 标签名称  |

#### 响应参数
| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| info  | String  | 提示消息  |
| status  | Integer  | 返回码  |
| data  | JSONObject  | 返回数据  |

**响应参数（data）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo | String  | 设备编号  |
| pass | String  | 设备密码  |

#### 返回码说明

| 返回码  | 说明  |
| ------------ | ------------ |
| 0 | 成功  |
| 1600  | 添加失败  |
| 1705  | 一个账号下最多添加500个设备  |
| 2006  | 设备添加错误  |
| 2016  | 设备已经存在  |
| 2018  | 设备名称为空  |
| 2020  | 设备类型为空  |
| 2036  | devid 太长  |
| 2044  | 设备密码长度应为8  |
| 2046  | 设备通讯密码错误  |
| 2048  | 设备编号为空  |
| 2052  | 设备sn校验失败  |
| 2084  | 设备的从机序号重复  |
| 2085  | 设备的从机地址重复  |
| 2086  | 设备的从机添加失败  |
| 2090  | qrcode 为空  |
| 2092  | qrcode格式错误  |
| 2120  | 设备在第三方云平台已存在  |
| 2122  | 设备在第三方云平台添加失败  |
| 2124  | 设备在第三方云平台已绑定  |
| 2127  | 设备最多关联三个标签  |
| 2130  | sn格式错误  |
| 5004  | 权限不足  |
| 5017  | 参数错误  |
| 5106 | 参数不完整  |
| 10017  | 添加报警联系人备注不规范  |

#### 请求示例

<pre>
POST https://openapi.mp.usr.cn/usrCloud/vn/dev/addDevice
Content-Type: application/json
	
{
    "relUserIds": [
        14407
    ],
    "device": {
        "projectId": 22508,
        "templateId": 2479,
        "deviceId": "",
        "QRcode": "deviceId:TEST***********,sn:TEST****************",
        "name": "设备名称",
        "img": "",
        "type": 10,
        "pass": "",
        "position": "117.02496707,36.68278473",
        "address": "山东省济南市历下区",
        "positionType": 1,
        "funcCloud": 1,
        "funcMonitor": 0,
        "isTransProtocol": 0
    },
    "tags": [
        {
            "tagName": "标签类别",
            "tagValue": "标签值"
        }
    ]
}
</pre>

#### 响应示例

status: 0，info: ok
<pre>
Content-Type: application/json
	
{
    "status": 0,
    "data": {
        "pass": "12345678",
        "deviceNo": "TEST***********"
    },
    "info": "ok"
}
</pre>