查询设备
更新时间：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其他字段 |
示例
-
请求示例
Text1GET /v1/device?pageNo=1&pageSize=10 HTTP/1.1 2host: {host} 3content-type: application/json 4authorization: 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 -
响应示例
Text1HTTP/1.1 200 OK 2x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2 3Date: Tue, 08 Now 2023 15:00:00 GMT 4Content-Type: application/json;charset=UTF-8 5 6{ 7 "pageNo":1, 8 "pageSize":10, 9 "totalCount":1, 10 "deviceList":[ 11 { 12 "id":"device-aaaaaa1", 13 "userId":"xxxx", 14 "tag":"test" 15 "state":"sleep", 16 "name":"设备1", 17 "venueName":"海淀区xx场馆", 18 "description":"海淀区xx场馆", 19 "address":"北京市海淀区xx路xx号", 20 "siteName":"足球1号场" 21 } 22 ] 23}