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

查询录制记录

最近更新时间：2021-09-03 16:32:30

描述

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

接口请求域名：qvs.qiniuapi.com
请求方式：GET
接口路径：/v1/namespaces/{namespaceId}/streams/{streamId}/recordhistories?start=<start>&end=<end>&marker=<marker>&line=<line>
Get请求，通过非SDK方式调用的客户，在http头部，请不要携带Content-Type 公共http header说明

请求参数

路径参数

参数名称	必填	字段类型	说明
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.type	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",
      "type":"realTime"
    },
  ],
  "marker": "eyJjIjowLCJrIjoicmVjb3JkLzJha3JhcnJ6bnM3NncvdDAvMTU4NzkxNjUxNTYyMC0xNTg3OTE3MTE3MTI1LTYwNDYzMS5tM3U4In0="
}

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