视频监控

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