查询设备
更新时间: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号场" } ] }