查询国标下级平台下设备列表
接口调用说明
请求地址 : /v1/api/platform/device/list
请求方式 : POST
请求头
| 参数名 | 参数值 | 是否必须 |
|---|---|---|
| Content-Type | application/json | 是 |
| X-Token | 实际 accessToken | 是 |
请求报文体
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| platformId | string | 是 | 下级平台 id |
| pageStart | int | 是 | 分页起始页(起始页=1) |
| pageSize | int | 是 | 分页大小(取值范围 1~500) |
//示例数据
{
"platformId": "37010200002000000001",
"pageStart": 1,
"pageSize": 10
}
响应报文
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | int | 是 | 状态码 |
| msg | String | 是 | 状态码解释信息 |
| data | Object | 是 | 返回内容 |
data 内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| page | object | 是 | 分页信息 |
| items | object[] | 是 | 设备列表信息 |
page 内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| total | int | 是 | 总行数 |
| curPage | int | 是 | 当前页数 |
| size | int | 是 | 页大小 |
items 内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| deviceSn | string | 是 | 设备序列号 |
| deviceName | string | 是 | 设备名称 |
| deviceState | int | 是 | 设备状态 0-离线 1-在线 |
//示例数据
{
"code": 1000,
"msg": "OK",
"data": {
"page": {
"total": 6,
"curPage": 1,
"size": 10
},
"items": [
{
"deviceSn": "37010200002000000001_00000000581314000091",
"deviceName": "演示设备",
"deviceState": 0
},
{
"deviceSn": "37010200002000000001_00000000581314000092",
"deviceName": "演示设备",
"deviceState": 0
},
{
"deviceSn": "37010200002000000001_00000000581314000093",
"deviceName": "演示设备",
"deviceState": 0
},
{
"deviceSn": "37010200002000000001_00000000581314000097",
"deviceName": "演示设备",
"deviceState": 0
},
{
"deviceSn": "37010200002000000001_00000000581314000100",
"deviceName": "演示设备",
"deviceState": 1
},
{
"deviceSn": "37010200002000000001_00000000581314000101",
"deviceName": "演示设备",
"deviceState": 1
}
]
}
}
错误码
| 状态码 | 状态描述 |
|---|---|
| 1000 | 成功 |
| 1001 | 参数错误 |
| 1002 | 请求异常 |
| 1006 | AccessToken 异常或过期 |
| 2019 | 平台 ID 不存在 |