根据条件获取设备列表-设备-有人云

#### 简要描述

根据条件获取设备列表

#### 请求 URL

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

#### 请求方式

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"|
| projectId | 可选 | String | Body | 组织 id |
| page_param | 可选 | String | Body | 分页参数 |
| search_param | 可选 | String | Body | 搜索参数 |
| searchByDeviceStatus | 可选 | String | Body | 根据sdk 状态查询   0 : 离线   1 : 在线   2 : 升级中   3 : 配置中   4 : 同步中   5 : 数据点报警   6 : 云监测报警 |
| needAlarmStatus | 可选 | String | Body | 是否需要报警状态   0:不需要(默认)   1 : 需要 |
| needUserAccount | 可选 | String | Body | 是否需要查询设备所属账号字段   0:不需要(默认)   1 : 需要 |

**请求参数（page_param）**

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| offset  | 可选  | Integer  | Body | 分页偏移量  |
| limit  |可选  | Integer  | Body | 分页数量  |

#### 响应参数

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

**响应数据（data）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| dev  | JSONArray  | 设备列表  |
| total  | String  | 设备数量  |

**响应数据（dev）**

| 名称 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| account | String | 账号 |
| address | String | 地址 |
| createTime | String | 创建时间 |
| deviceStatus | JSONObject | 设备状态 |
| devid | String | 设备的SN |
| funcCloud | String | 云组态状态   0 : 关闭   1 : 开启 |
| funcMonitor | String | 云监测状态   0 : 关闭   1 : 开启 |
| img | String | 图片地址 |
| name | String | 设备名称 |
| onlineStatus | String | 离线状态   0 : 离线   1 : 在线 |
| pass | String | 通讯密码 |
| position | String | 经纬度位置 |
| projectId | String | 组织id |
| projectName | String | 组织名称 |
| sn | String | 设备sn |
| templateId | String | 模板id |
| type | String | 设备类型，默认10 |
| updateTime | String | 更新时间 |
| verifyCode | String | 设备验证码 |
| weight | String | 权重 (用于排序) |

**响应数据（deviceStatus）**

| 名称 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| datapointAlarm | String | 数据点报警 |
| forbidden | String | |
| monitorAlarm | String | 云监测报警 |
| onlineOffline | String | 离线状态   0 : 离线   1 : 在线 |
| set | String | 对应的配置 |
| sync | String | 同步中 |
| update | String | 升级中 |
| version | String | 版本 |

#### 返回码说明

| 返回码  | 说明  |
| ------------ | ------------ |
| 0 | 成功  |
| 5004  | 权限不足  |

#### 请求示例

<pre>
POST https://openapi.mp.usr.cn/usrCloud/vn/dev/getDevs
Content-Type: application/json
	
{
	"projectId" : null,
	"page_param" : {
		"offset" : 0,
		"limit" : 10
	},
	"search_param" : "设备名",
	"searchByDeviceStatus" : "0",
	"needAlarmStatus" : 1,
	"needUserAccount" : 1
}
</pre>

#### 响应示例

status : 0，info: ok

<pre>
Content-Type: application/json
	
{
	"data" : {
		"dev" : [
			{
				"account" : "aaaaa",
				"address" : "山东省济南市历下区",
				"createTime" : 1567475721,
				"deviceStatus" : {
					"datapointAlarm" : 0,
					"forbidden" : 0,
					"monitorAlarm" : 0,
					"onlineOffline" : 0,
					"set" : 0,
					"sync" : 0,
					"update" : 0,
					"version" : ""
				},
				"devid" : "00000000000000000004",
				"funcCloud" : 1,
				"funcMonitor" : 0,
				"id" : 228422,
				"img" : "",
				"name" : "未命名_设备名称_",
				"onlineStatus" : 0,
				"pass" : "iBRpWIiz",
				"position" : "117.02496707,36.68278473",
				"projectId" : 00000,
				"projectName" : "test4",
				"sn" : "00000000000000000004",
				"templateId" : 868,
				"type" : 10,
				"updateTime" : 1567479067,
				"verifyCode" : "sfecawe5",
				"weight" : 0
			},
			...
		],
	"total" : 1
	},
	"info" : "ok",
	"status" : 0
}
</pre>