查询RTMP设备录像列表
更新时间：2022-02-17
接口描述
本接口用于查询设备的录像文件列表。
请求（Request）
请求URI
GET /v1/device/{deviceId}/recording?begin={begin}&end={end}&pageNo={pageNo}&pageSize={pageSize}
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| deviceId | Long | 是 | 设备ID |
| begin | Integer | 是 | 录像开始时间，Unix时间戳，单位秒，形如"1617261115" |
| end | Integer | 是 | 录像结束时间，Unix时间戳，单位秒，形如"1617261132" |
| pageNo | Integer | 是 | 分页查询标识第几页 |
| pageSize | Integer | 是 | 分页查询标识每页多少条数据 |
注意： begin与end参数组成一个左闭右开区间[start, end)，查询时以录像的开始时间为查询点，在区间内进行查询。 举例如下： 若配置录像单文件时长为1小时，在一段时间后，存在以下录像文件：
- record.a.mp4, startTime=2021-04-01 11:05:00
- record.b.mp4, startTime=2021-04-01 12:05:01
- record.c.mp4, startTime=2021-04-01 13:04:59
- record.d.mp4, startTime=2021-04-01 14:05:00
- record.e.mp4, startTime=2021-04-01 15:05:00 然后发起查询录像请求，指定参数start=1617247800(2021-04-01 11:30:00)，end=1617258600(2021-04-01 14:30:00)，会发现得到响应结果录像文件列表为 [record.b.mp4, record.c.mp4, record.d.mp4]，不要怀疑，这完全符合系统预期。请理解查询录像的维度始终是录像开始时间，在多个连续的查询请求中，EVS会返回所有的录像文件。
请求头域
除公共头域外，无其它特殊头域。
请求体
无
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| pageNo | Integer | 当前页数 |
| pageSize | Integer | 当前页的大小 |
| data | Array | 空间信息列表 |
| + title | String | 设备录像文件标题 |
| + thumbnailUrl | String | 设备录像封面图链接，从录像时段内随机取一张图 |
| + playUrl | String | 录像播放链接 |
| totalCount | Integer | 总个数 |
示例
请求示例
GET /v1/device/1000001/recording?begin=1583335807&end=1583335807&pageNo=1&pageSize=10 HTTP/1.1
x-bce-date: 2020-03-25T09:28:13Z
host: evs.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"pageNo": 1,
"pageSize": 10,
"data": [
{
"title": "2020.06.28 19:10:11-19:11:11",
"thumbnailUrl": "http://xxx.xxx/xxx/xxx.jpg"
"playUrl": "http://xxx.xxx/xxx/xxx.mp4"
},
{
"title": "2020.06.28 19:11:11-19:12:12",
"thumbnailUrl": "http://xxx.xxx/xxx/xxx.jpg"
"playUrl": "http://xxx.xxx/xxx/xxx.mp4"
}
]
}错误码
参考公共错误码