获取设备列表-设备-有人云

#### 简要描述

获取设备列表

#### 请求 URL

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

#### 请求方式

POST

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| X-Access-Token | 必选  | String  | Header |  登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用，[获取详情](http://cloud.usr.cn/document/1286.html "获取详情")） |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"|
| projectId | 可选  | Integer  | Body | 组织ID  |
|allCusdeviceStatus| 可选  | Integer  | Body |  设备状态 （0：未配置 1：已配置 2：变量报警 3：在线 4：离线） |
| cusdeviceName | 可选  | Integer  | Body |  设备名称 |
|tags  | 可选  | JSONArray | Body |标签列表   |
|templateId  | 可选  | Integer  | Body |  模板id 不传就是所有模板 |
| pageNo | 可选  | Integer  | Body | 页号,为空时,默认为 1  |
| pageSize | 可选  | Integer  | Body |一页大小,为空时,默认为 10,最大返回 500|

**请求参数（tags）**

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

#### 响应参数

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

#### 响应参数（data)

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| cusdeviceResponseDTO  | JSONArray  | 设备列表  |
| total  | Long  | 提示消息  |

#### 响应参数（cusdeviceResponseDTO)

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| cusdeviceName  | String  | 设备名称  |
| cusdeviceNo  | String  | 设备编号  |
|deviceNo|String|绑定的网关编号|
|cusdeviceStatus|JSONObject|设备状态|
| projectId  | Integer  |  组织ID |
| projectName  | String  | 组织名称  |
|templateId| Integer  |设备模板ID 未关联设备模板 该字段为空|
| deviceName  | String  | 网关名称 未关联设网关 该字段为空  |
|tagValues   | String  | 设备标签列表  |
|position   | String  | 坐标  |
|positionType   | Integer  | 定位类型 （0：不定位，1:手动定位，2：自动定位）  |
|address   | String  | 客户设备地址  |

**响应参数（cusdeviceStatus）**

| 名称  | 必选/可选  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| cusdeviceConfigStatus  | Integer  |配置状态： 0：未配置 1：已配置|
| onlineOffline  | Integer  | 上下线状态： 0：下线 1：上线  |
|scadaAlarm| Integer  | 变量报警状态： 0：未在报警状态 1：报警中 ,默认为0  |

#### 返回码说明

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

#### 请求示例
<pre>
POST https://openapi.mp.usr.cn/usrCloud/V6/cusdevice/getCusdevices
Content-Type: application/json

{
    "pageNo": 1,
    "pageSize": 10,
    "projectId": 172808,
    "allCusdeviceStatus": 3,
    "cusdeviceName": "1",
    "tags": [
        {
            "id": 65668,
            "tagName": "aaa",
            "tagValue": "jkl",
            "selectStatus": true
        }
    ]
}
</pre>

#### 响应示例

status: 0，info: ok

<pre>
Content-Type: application/json
	
{
    "status": 0,
    "data": {
        "cusdeviceResponseDTO": [
            {
                "cusdeviceName": "未命名_网关名称_10",
                "cusdeviceNo": "0000005842000006",
                "deviceNo": "00005842014003180939",
				"cusdeviceStatus": {
					"cusdeviceConfigStatus": 1,
					"onlineOffline": 1,
					"scadaAlarm": 1
				}
                "multiSlaveMode": 0,
                "projectId": 172808,
                "projectName": "根组织",
                "templateId": 213510,
                "templateName": "未命名-2023-05-30 18:01:30",
                "deviceName": "触发器测试1",
                "position": "",
                "positionType": 1,
                "address": "北京市东城区天安门"
            }
        ],
        "total": 3
    },
    "info": "ok",
    "account": "xxx"
}
</pre>