查询国标下级平台下设备列表
接口调用说明
请求地址 : /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 不存在 |