查询录制记录
描述
本接口用于查询视频流的录制记录
- 接口请求域名:
qvs.qiniuapi.com
- 请求方式:GET
- 接口路径:
/v1/namespaces/{namespaceId}/streams/{streamId}/recordhistories?start=<start>&end=<end>&marker=<marker>&line=<line>
请求参数
路径参数
参数名称 | 必填 | 字段类型 | 说明 |
---|---|---|---|
namespaceId | 是 | string | 空间名称ID |
streamId | 是 | string | rtmp接入时传入流ID,国标接入传入国标ID |
marker | 否 | string | 如果查询的记录过多,本接口可能需要循环多次调用来获取全部记录。marker值表示当前的查询位置,第一次查询置空,后面可通过该接口返回参数获取,从而保证可以不间断获取全部记录。例如:总共要查200条记录,第一次查询了100条,第二次传入第一次返回的marker值继续查,又查询100条,第二次返回的marker为空,表示查询结束。 |
line | 否 | integer | 一次返回多少条 |
start | 是 | integer | 查询开始时间(unix时间戳,单位为秒) |
end | 是 | integer | 查询结束时间(unix时间戳,单位为秒) |
format | 否 | string | 录制视频格式 |
响应参数
参数名称 | 类型 | 说明 |
---|---|---|
items | 流数组 | 流数组 |
items.url | string | 播放地址 |
items.start | integer | 录制开始时间(unix时间戳,单位为秒) |
items.end | integer | 录制结束时间(unix时间戳,单位为秒) |
items.duration | integer | 录制时长单位为秒 |
items.snap | string | 录制封面图片地址 |
items.format | int | 1表示m3u8文件,2表示flv文件,4表示mp4文件 |
items.file | string | 对应云存储中的文件名 |
marker | string | 下次查询的marker,如果为空说明记录查询完毕,如果不为空说明记录没有查完,需要重复调用此接口再次查询 |
示例
请求示例
curl --request GET \
--url 'qvs.qiniuapi.com/v1/namespaces/2akrarrzns76w/streams/t0/recordhistories?start=1587899020&end=1587968104' \
--header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
响应示例
{
"items": [
{
"url": "http://prlghu509.test.bkt.clouddn.com/record/2akrarrzns76w/t0/1587898457113-1587899058364-601408.m3u8?pm3u8/0/expire/7200&e=1587975245&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:RrS5TIARP3aBREpQJIKC0Rf3FAE",
"start": 1587898457,
"end": 1587899058,
"duration": 601,
"format": 1,
"snap": "http://prlghu509.test.bkt.clouddn.com/record/2akrarrzns76w/t0/1587898457113-1587899058364-601408.m3u8?pm3u8/0/expire/7200&vframe/jpg/offset/0&e=1587975245&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:DW9iifbZWTCJkRSdRr_cXzWmGg8",
"file":"record/2akrarrzns76w/t0/1587898457113-1587899058364-601408.m3u8"
},
{
"url": "http://prlghu509.test.bkt.clouddn.com/record/2akrarrzns76w/t0/1587899050326-1587899651641-601127.m3u8?pm3u8/0/expire/7200&e=1587975245&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:WGLFd8CCLDfStQvGagkI9wahMLk",
"start": 1587899050,
"end": 1587899651,
"duration": 601,
"format": 1,
"snap": "http://prlghu509.test.bkt.clouddn.com/record/2akrarrzns76w/t0/1587899050326-1587899651641-601127.m3u8?pm3u8/0/expire/7200&vframe/jpg/offset/0&e=1587975245&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:D5hg2KmUrM6DP1Mp14tNtBAhK_w",
"file":"record/2akrarrzns76w/t0/1587899050326-1587899651641-601127.m3u8"
},
],
"marker": "eyJjIjowLCJrIjoicmVjb3JkLzJha3JhcnJ6bnM3NncvdDAvMTU4NzkxNjUxNTYyMC0xNTg3OTE3MTE3MTI1LTYwNDYzMS5tM3U4In0="
}
文档反馈
(如有产品使用问题,请提交工单)