查询设备
更新时间：2024-06-06
查询设备
接口描述
本接口用于查询当前用户的设备
请求
请求路径
| Path | Method | 说明 |
|---|---|---|
| /v1/device | GET | 获取该用户下的设备列表 |
请求参数
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| pageSize | Int | 是 | 每页数量 |
| pageNo | Int | 是 | 页码 |
| name | Int | 否 | 设备名称（支持模糊匹配） |
| deviceId | Int | 否 | 设备ID（支持模糊匹配） |
请求头
无其他特殊头域
请求体
无
响应
响应头域
除公共头域外，无其他特殊头域。
响应体
| 参数名 | 类型 | 描述 | 备注 |
|---|---|---|---|
| pageNo | Int | 页码 | |
| pageSize | Int | 每页数量 | |
| totalCount | Int | 总数量 | |
| deviceList | List | 返回的设备列表 | |
| +id | String | 设备ID | 唯一标识一个设备 |
| +name | String | 设备名称 | |
| .... | ..... | 详见实体说明中Device其他字段 |
示例
-
请求示例
GET /v1/device?pageNo=1&pageSize=10 HTTP/1.1 host: {host} content-type: application/json authorization: bce-auth-v1/f1a2705d3cf8448cb917684c4f40ac1f/2023-11-08T07:19:17Z/3600/host;x-bce-account;x-bce-console-rpc-id;x-bce-date;x-bce-request-id/31b7dce808571441fb78077e74c048495945536909bbebd37e4037b7c796bf15 -
响应示例
HTTP/1.1 200 OK x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2 Date: Tue, 08 Now 2023 15:00:00 GMT Content-Type: application/json;charset=UTF-8 { "pageNo":1, "pageSize":10, "totalCount":1, "deviceList":[ { "id":"device-aaaaaa1", "userId":"xxxx", "tag":"test" "state":"sleep", "name":"设备1", "venueName":"海淀区xx场馆", "description":"海淀区xx场馆", "address":"北京市海淀区xx路xx号", "siteName":"足球1号场" } ] }
