添加网关-网关-有人云

#### 简要描述

添加网关

#### 请求 URL

https://openapi.mp.usr.cn/usrCloud/V6/device/addDevice

#### 请求方式

POST

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| X-Access-Token | 必选  | String  | Header |  登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用，[获取详情](http://cloud.usr.cn/document/362.html "获取详情")） |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"|
| sn | 可选  | String  | Body | 网关SN,非必填, 不填的认为默认添加为TCP网关,SN自动生成 SN填写的但netWorkId未填写的也默认添加为TCP网关,此处SN会有格式校验,前三位必须为000，后0-6位是用户id不可更改  |
| netWorkId | 可选  | String  | Body | 网关标识号, MAC、IMEI、NID，用于添加网关时候和SN进行匹配  |
| devicePass | 可选  | String  | Body | 网关通讯密码,添加TCP网关时传此项按照此项定为通讯密码，不传此项则会随机生成通讯密码,有MAC、IMEI、NID的MQTT网关不需要传此项 |
| deviceName | 必选  | String  | Body |  网关名称,必填 |
| projectId | 必选  | String  | Body | 网关绑定的组织id,必填  |
| devicePosition | 可选  | String  | Body | 网关所在位置经纬度（定位类型选择固定位置时指定值）  |
| devicePositionType | 必选  | String  | Body | 网关定位类型 1 固定位置（选择此项需在deviceAddress、devicePosition项指定值） 2 自动定位（选择此项需绑定支持自动定位的网关）,必填  |
| deviceAddress | 可选  | String  | Body | 网关所在地址（定位类型选择固定位置时指定值）  |
| funcMonitor | 可选  | Integer  | Body |  网关是否开启网络监测, 1为开启 0为关闭 |
| isTransProtocol | 可选  | Integer  | Body |  网关是否开启透传, 1为开启 0为关闭 |
| verifyCode | 可选  | String  | Body | 网关验证码,非必填,用于小程序扫码添加从云平台导出的二维码时使用的校验码，扫码网关上的二维码时不需传此字段 |
| deviceTagSetDatas | 可选  | JSONArray  | Body | 网关绑定标签数据设置信息，非必填 |

**请求参数（deviceTagSetDatas）**

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

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

**响应参数（data）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo | String  | 网关编号  |
| pass | String  | 网关密码  |

#### 返回码说明

| 返回码  | 说明  |
| ------------ | ------------ |
| 0 | 成功  |
| 1600  | 添加失败  |
| 1705  | 一个账号下最多添加500个网关  |
| 2006  | 网关添加错误  |
| 2016  | 网关已经存在  |
| 2018  | 网关名称为空  |
| 2020  | 网关类型为空  |
| 2036  | 网关编号太长  |
| 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/V6/device/addDevice
Content-Type: application/json
	
{
    "deviceName": "网关1",
    "projectId": 172808,
    "devicePositionType": 1,
    "devicePosition": "117.12639941,36.6565542",
    "deviceAddress": "山东省济南市历下区龙奥南路",
    "funcMonitor": 0,
    "isTransProtocol": 0,
    "deviceTagSetDatas": [
        {
            "tagName": "type1",
            "tagValue": "tag1"
        }
    ]
}

</pre>

#### 响应示例

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