CDN加速

视频拉取查询

更新时间:2021-01-27 16:09:09

描述

查询视频拉取任务结果

请求说明

请求方式 Post/get
接口地址 https://api.cloudv.haplat.net/vod/videoManage/pullVideoQuery
是否需要凭证 需要校验凭证

请求参数

参数名 类型 是否必填 描述
taskId string 任务ID
taskId和transNo至少传一个,taskId优先使用
transNo string 业务ID
taskId和transNo至少传一个,taskId优先使用

返回参数

通用返回结果详见返回结果
成功时返回的data参数的数据结构

参数名 类型 描述
taskId string 任务ID。
transNo string 业务ID
timestamp long 毫秒级时间戳
status int 任务状态
取值范围 :
  • 1(处理中)
  • 2(已完成)
  • items array 每个视频拉取结果状态信息。
    如果处理请求包括多个视频,则items包含多条信息。

    items字段数据格式

    参数名 类型 描述
    fileName string 文件名
    fetchUrl string 拉取URL
    md5 string 视频md5
    pullStatus string 拉取任务执行状态
    取值范围 :
  • 1(处理中)
  • 2(成功)
  • 3(失败)
  • cmdStatus string 一体化命令执行状态
    取值范围 :
  • 1(处理中)
  • 2(成功)
  • 3(失败)
  • videoInfo obj 包含视频id,视频文件列表。
    视频信息包含码率,清晰度,分辨率,终端类型,视频URL

    videoInfo字段数据格式

    参数名 类型 描述
    videoId string 视频id
    duration double 时长
    videoFileList array 视频文件列表

    videoFileList字段数据格式

    参数名 类型 描述
    clarity int 清晰度。取值范围 :
  • 1(原画)
  • 2(流畅)
  • 3(标清)
  • 4(高清)
  • 5(超清)
  • serverType int 终端类型。取值范围 :
  • 0(PC)
  • 1(原视频)
  • bitrate int 码率
    resolution string 分辨率
    fileSize long 文件大小
    fileUrl string 视频url

    示例

    输入示例

    
    curl -X POST http://api.cloudv.haplat.net/vod/videoManage/pullVideoQuery
      -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' 
      -H "Host: api.cloudv.haplat.net" 
      <公共的头部参数>
      <自定义的头部参数>
      -d 'taskId=aaaaabbbbbccccc'
    
    

    注意:示例中的“公共参数”参见公共参数说明文档

    输出示例

    
    {
        "code": 200,
        "data": {
            "items": [
                {
                    "cmdStatus": 2,
                    "fetchUrl": "http://ovptest.haplat.net/pullvideo/201709/9828dc65015e10009c2920a600000000/testpull.flv",
                    "fileName": "testpull1.flv",
                    "md5": "",
                    "pullStatus": 2,
                    "videoInfo": {
                        "duration": 105,
                        "videoFileList": [
                            {
                                "bitrate": 412,
                                "clarity": 1,
                                "fileSize": 5384542,
                                "fileUrl": "pullvideo/201709/983afec9015e10006b97c47b00000000/testpull1.flv",
                                "resolution": "360:1080",
                                "serverType": -1
                            },
                            {
                                "bitrate": 398,
                                "clarity": 2,
                                "fileSize": 929,
                                "fileUrl": "pullvideo/201709/983afec9015e10006b97c47b00000000/983ed602015e100085d5fdd300000000-01.m3u8",
                                "resolution": "640:360",
                                "serverType": 0
                            }
                        ],
                        "videoId": "983ed602015e100085d5fdd300000000"
                    }
                }
            ],
            "status": 2,
            "taskId": "983af870015e10001885297a00000000",
            "timestamp": 1505803059873,
            "transNo": "0bf4cc34824004b1c4cb48fed63d620a"
        },
        "message": "操作成功"
    }
    
    

    错误码

    无接口业务逻辑相关的错误码,通用错误码详见 返回结果