视频监控 > API 文档 > 录制管理相关接口 >查询录制记录

查询录制记录

最近更新时间：2020-12-31 10:58:27

描述

本接口用于查询视频流的录制记录

接口请求域名：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="
}

以上内容是否对您有帮助？