获取网关列表-网关-有人云

#### 简要描述

获取网关列表

#### 请求 URL

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

#### 请求方式

POST

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| X-Access-Token | 必选  | String  | Header |  登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用，[获取详情](http://cloud.usr.cn/document/1286.html "获取详情")） |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"|
| projectId | 可选  | String  | Body | 组织 id  |
| searchParam | 可选  | String  | Body | 搜索参数  |
| deviceStatus | 可选  | String  | Body | 网关状态检索（0：离线 1：在线 2、升级中 3、配置中 6、网关报警） |
| pageNo | 可选  | Integer  | Body |   页号,为空时,默认为 1|
| pageSize | 可选  | Integer  | Body |  一页大小,为空时,默认为 10,最大返回 500 |

#### 响应参数

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

**响应数据（data）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo  | String  | 网关编号  |
| projectId  | String  | 组织id  |
| projectName  | String  | 组织名称  |
| deviceName  | String  | 网关名称  |
| deviceAddress  | String  | 地址  |
| deviceCreateTime  | String  | 创建时间  |
| devicePosition  | String  | 经纬度位置  |
| deviceEnableStatus  | Integer  | 网关启用禁用状态(1 启用 0 禁用)  |
| deviceFuncMonitor  | Integer  | 网关网络监测开关（ 0 关闭 1 开启）|
| deviceIsTransProtocol  | Integer  | 网关是否开启透传（ 0 关闭 1 开启）|
| deviceVerifyCode  | String  | 设备验证码  |
| deviceTags  | JSONArray  | 网关标签|
| devicePass  | JSONObject  | 网关通讯密码|

**请求参数（deviceTags）**

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

**响应数据（deviceStatus）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo  | String  | 网关编号  |
|  onlineOffline |  Integer |   上下线 0：下线，1：上线|
| update  |  Integer | 升级 0：不升级，1：升级  |
| set  |  Integer |  配置 0:不配置，1：配置中 |
|  monitorAlarm |Integer|  报警 0：不报警，1:报警中 |
|  onlineTime | Integer  |上线时间（时间戳秒）|

#### 返回码说明

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

#### 请求示例

<pre>
POST https://openapi.mp.usr.cn/usrCloud/V6/device/getDevices
Content-Type: application/json
	
{
    "status": 0,
    "data": {
        "total": 10,
        "list": [
            {
                "deviceNo": "00005842014003180941",
                "projectId": 172808,
                "projectName": "根组织",
                "deviceName": "未命名_网关名称_10",
                "deviceAddress": "山东省济南市历下区龙奥南路",
                "deviceCreateTime": 1685518750,
                "devicePosition": "117.12639941,36.6565542",
                "devicePositionType": 1,
                "sn": "00005842014003180941",
                "deviceEnableStatus": 2,
                "deviceFuncMonitor": 0,
                "deviceIsTransProtocol": 0,
                "deviceVerifyCode": "yr4gy0jd",
                "deviceStatus": {
                    "deviceNo": "00005842014003180941",
                    "onlineOffline": 0,
                    "sync": 0
                },
                "ownerUid": 5842,
                "devicePass": "12345678"
            }
        ],
        "pageNum": 0,
        "pageSize": 0,
        "size": 0,
        "startRow": 0,
        "endRow": 0,
        "pages": 0,
        "prePage": 0,
        "nextPage": 0,
        "isFirstPage": false,
        "isLastPage": false,
        "hasPreviousPage": false,
        "hasNextPage": false,
        "navigatePages": 0,
        "navigateFirstPage": 0,
        "navigateLastPage": 0,
        "firstPage": 0,
        "lastPage": 0
    },
    "info": "ok",
    "account": "xxx"
}
</pre>

#### 响应示例

status : 0，info: ok

<pre>
Content-Type: application/json
	
{
    "searchParam": "",
    "projectId": 172808,
    "pageNo": 1,
    "pageSize": 1
}
</pre>