获取设备详情-设备-有人云

#### 简要描述

获取设备详情

#### 请求 URL

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

#### 请求方式

POST
#### 用户等级
:fa-check-square-o: 基础版 :fa-check-square-o: 企业版 :fa-check-square-o: 旗舰版

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| X-Access-Token | 必选  | String  | Header |  登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用，[获取详情](http://cloud.usr.cn/document/362.html "获取详情")） |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"|
| deviceId | 必选  | String  | Body | 设备的SN  |

#### 响应参数

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

**响应数据（data）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| device  | JSONObject  | 设备详情  |
| deviceSlaves  | JSONObject  | 从机详情  |
| slaveTotal  | Integer  | 从机数量  |
| deviceTags  | JSONObject  | 设备标签数量  |

**响应数据（device）**

| 名称 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| id | Integer | 主键id
| account | String | 账号名称
| address | String | 地址
| alarmStatus | Integer | 报警状态   0 : 正常   1 : 报警 |
| deviceId | String | 设备的SN |
| img | String | 图片地址 |
| name | String | 设备名称 |
| onlineStatus | Integer | 离线状态   0 : 离线   1 : 在线 |
| pass | String | 通讯密码 |
| position | String | 经纬度 |
| protocol | Integer | 通讯协议   0 : Modbus RTU   1 : Modbus TCP   2 : TCP 透传   3 : DL/T645-97   4 : DL/T645-07   5 : 烟感协议   6 : PLC联网终端数据分发协议   101：新版plc云网关（s7comm协议 ） |
| templateId | Integer | 模板id |
| type | Integer | 设备类型   0 : 默认设备   1 : lora集中器   2 : CoAP/NB-IoT   3 : lora模块   4 : 网络id   5 : 扫码支付 |
| updateTime | String | 设备更新时间 |
| createTime | String | 设备创建时间 |
| weight | Integer | 权重（自定义排序 |
| ownerUid | Integer | 设备所属用户id |
| status | Integer | 设备状态   1 : 已启用   2 : 已禁用 |
| sn | String | 设备sn |
| templateName | String | 设备关联模板名称 |
| positionType | Integer | 设备定位类型   0 : 不定位   1 : 固定位置   2 : 设备自动定位 |
| projectId | Integer | 设备所属组织id |
| projectName | String | 设备所属组织名称 |
| funcCloud | Integer | 是否开启云组态功能   1 : 为开启   0 : 为关闭 |
| funcMonitor | Integer | 是否开启云监测功能   1 : 为开启   0 : 为关闭 |
| isBindAlarmConfig | Integer | 是否绑定报警配置   0 ：未绑定   1 ：已绑定 |
| isTransProtocol | Integer | 是否为透传协议设备   0 ：不是   1 ：是 |
| deviceStatus | JSONObject | 设备状态集合 |

**响应数据（deviceStatus）**

| 名称 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| deviceId | String | 设备的SN |
| onlineOffline | Integer | 离线状态   0 : 离线   1 : 在线 |
| update | Integer | 升级   0 ：未升级   1 ：升级中 |
| set | Integer | 配置   0 :不配置   1 ：配置中 |
| sync | Integer | 同步   0 : 不同步   1 ：同步中 |
| datapointAlarm | Integer | 数据点报警   0 ：不报警   1 ：报警中 |
| forbidden | Integer | 是否禁用   0 ：不禁用   1 ：禁用 |
| monitorAlarm | Integer | 云监测报警   0 ：不报警   1 : 报警中 |
| onlineTime | Integer | 上线时间 |

**响应数据（deviceSlaves）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| createDt  | String  | 创建时间  |
| creator  | Integer  | 创建人id  |
| deviceTemplateId  | Integer  | 设备模板id  |
| id  | String  | 设备id  |
| slaveIndex  | String  | 从机编号  |
| slaveIp  | Integer  | 从机ip  |
| slaveName  | String  | 从机名称  |
| slavePort  | Integer  | 从机端口  |
| updateDt  | Integer  | 从机更新时间  |
| updator  | Integer  | 更新人id  |
| userId  | Integer  | 用户id  |

**响应数据（deviceTags）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo  | String  | 设备的SN  |
| creator  | Integer  | 创建人id  |
| id  | Integer  | 标签id  |
| tagName  | String  | 标签类别  |
| tagValue  | String  | 标签名称  |

#### 返回码说明

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

#### 请求示例
<pre>
POST https://openapi.mp.usr.cn/usrCloud/dev/getDevice
Content-Type: application/json
	
{
 "deviceId": "WSC20190523001"
}
</pre>

#### 响应示例

status: 0，info: ok

<pre>
Content-Type: application/json
	
{
 "data": {
 "device": {
			"id": 50785,
 "account": "test2",
 "address": "山东省济南市历下区",
 "alarmStatus": 0,
 "deviceId": "00000000000000000001",
 "img": "",
 "name": "测试",
 "onlineStatus": 0,
 "pass": "12346578",
 "position": "117.02496707,36.68278473",
 "protocol": 101,
 "templateId": 117,
 "type": 10,
			"createTime": 1610333543,
 "updateTime": 1551343426,
 "weight": 0,
			"ownerUid": 23598,
			"status": 1,
			"sn": "00000000000000000001",
			"templateName": "kk-云端轮询2",
			"groupName": "我的分组",
			"positionType": 1,
			"projectId": 44622,
 "projectName": "项目二",
			"funcCloud": 1,
 "funcMonitor": 0,
			"isBindAlarmConfig": 0,
 "isTransProtocol": 0,
			"deviceStatus": {
 "deviceId": "00000000000000000001",
 "onlineOffline": 0,
 "update": 0,
 "set": 0,
 "sync": 0,
 "datapointAlarm": 0,
 "forbidden": 0,
 "monitorAlarm": 0,
 "onlineTime": 0
 }
 }
 },
 "deviceSlaves": [
 {
 "createDt": 1551086130000,
 "creator": 4299,
 "deviceTemplateId": 117,
 "id": 175,
 "slaveIndex": "1",
 "slaveIp": "192.168.1.5",
 "slaveName": "测试从机",
 "slavePort": 4800,
 "updateDt": 1551161893000,
 "updator": 4299,
 "userId": 4299
 },
 		...
 ],
	"deviceTags": [
 {
 "creator": 4299,
 "deviceNo": "00000000000000000001",
 "id": 44158,
 "tagName": "2",
 "tagValue": "11"
 },
			...
	],
	"slaveTotal": 1
}
</pre>