获取点播截图信息更新时间：2020-11-24 20:41:20

获取点播截图信息

基本信息

Path： /api/v2/vod

接口描述：

获取符合指定条件的点播视频的截图信息。

场景描述：

可将截图筛选出来用作点播视频的媒体封面图，利用媒体封面图的接口，指定截图路径设为封面

请求参数

Query

参数名称 类型 是否必须 示例 备注
action string 是 GetVodSnapshotInfo 固定参数，GetVodSnapshotInfo
app_id string 是 app_id
vod_id string 是 4377e1d5 点播ID
page_num int 否 0 页号。默认值：0
page_size int 否 10 分页大小。默认值：10。最大不超过100。

出参

参数 类型 是否必选 含义
total int 是 符合条件的截图总数
snapshots json 是 截图详情列表
page_num int 是 当前页,当前请求页数，注意默认从0开始
page_all int 是 总页数

截图详情

参数 类型 是否必选 含义
image_id int 是 截图id,唯一标识
image_uri string 是 截图文件路径
size int 是 截图大小，单位KB
width int 是 图片宽度，单位px
height int 是 图片高度，单位px

返回数据

{
  "msg": "success",
  "code": 200,
  "data": {
    "total": 7,
	"page_num": 0,
    "page_all": 1,
    "snapshots": [
      {
        "height": 480,
        "image_id": 64,
        "size": 25,
        "width": 854,
        "image_uri": "http://xxxxx.vhall.com/vhallyun/vhallimage/eca40157/20191122182924/img-00001.jpg"
      },
      {
        "height": 480,
        "image_id": 66,
        "size": 28,
        "width": 854,
        "image_uri": "http://xxxxx.vhall.com/vhallyun/vhallimage/eca40157/20191122182924/img-00002.jpg"
      },
      {
        "height": 480,
        "image_id": 65,
        "size": 43,
        "width": 854,
        "image_uri": "http://xxxxx.vhall.com/vhallyun/vhallimage/eca40157/20191122182924/img-00003.jpg"
      },
      {
        "height": 480,
        "image_id": 68,
        "size": 42,
        "width": 854,
        "image_uri": "http://xxxxx.vhall.com/vhallyun/vhallimage/eca40157/20191122182924/img-00004.jpg"
      },
      {
        "height": 480,
        "image_id": 63,
        "size": 41,
        "width": 854,
        "image_uri": "http://xxxxx.vhall.com/vhallyun/vhallimage/eca40157/20191122182924/img-00005.jpg"
      },
      {
        "height": 480,
        "image_id": 67,
        "size": 40,
        "width": 854,
        "image_uri": "http://xxxxx.vhall.com/vhallyun/vhallimage/eca40157/20191122182924/img-00006.jpg"
      },
      {
        "height": 480,
        "image_id": 62,
        "size": 47,
        "width": 854,
        "image_uri": "http://xxxxx.vhall.com/vhallyun/vhallimage/eca40157/20191122182924/img-00007.jpg"
      }
    ]
  },
  "request_id": "9DC7E1F9-84E0-4079-99C5-D4895C18589A"
}