视频监控

  • 视频监控 > 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="
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close