查询GB28181设备通道录像列表
更新时间:2022-02-17
接口描述
本接口用于查询GB28181设备通道的录像文件列表。
请求(Request)
请求URI
GET /v1/device/channel/{channelId}/recording?begin={begin}&end={end}&pageNo={pageNo}&pageSize={pageSize}
参数名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
channelId | 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/channel/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"
}
],
totalCount: 2
}
错误码
参考公共错误码