视频监控

  • 视频监控 > API 文档 > 录制管理相关接口 >获取截图列表

    获取截图列表

    最近更新时间:2021-09-07 16:02:45

    描述

    本接口用于查询流截图记录

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

    请求参数

    路径参数

    参数名称 必填 字段类型 说明
    namespaceId string 空间名称ID
    streamId string 流ID
    line integer 限定返回截图的个数,只能输入1-100的整数,不指定默认返回30个,type为3可忽略
    marker string 上一次查询返回的标记,用于提示服务端从上一次查到的位置继续查询,不指定表示从头查询,type为3可忽略
    start integer 查询开始时间(unix时间戳,单位为秒),type为3可忽略
    end integer 查询结束时间(unix时间戳,单位秒),type为3可忽略
    type integer 1:实时截图对应的图片列表 2: 按需截图对应的图片列表 3:覆盖式截图对应的图片

    响应参数

    参数名称 类型 说明
    items 截图数组 截图数组
    items.snap string 截图url
    items.file string 对应云存储中的文件名
    items.time integer 截图时间点(unix时间戳 单位为秒),覆盖式截图不返回
    marker string 返回的列举位置标记,作为下次列举的起点信息,为空表示全部返回完毕,覆盖式截图不返回

    示例

    请求示例

    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device005/snapshots?type=1&start=1586828065&end=1586828456 \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

    响应示例

    {
      "items": [
        {
          "snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828085507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:atGE_HnerdP2TF1fDSlv2HRurcw",
          "file":"snapshot/jpg/d102sni9zryu/device005/1586828085507.jpg",
          "time": 1586828085
        }, 
        {
          "snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828461726.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:AcRKnwvxxDc4kgg22RwbaiiAJYM",
          "file":"snapshot/jpg/d102sni9zryu/device005/1586828461726.jpg",
          "time": 1586828461
        }
      ],
      "marker": ""
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close