发起视频上传

最近更新时间:2019-05-10 18:46:37

接口名称

ApplyUpload

功能说明

  1. 发起视频文件(和视频封面文件)的上传,获取文件上传到腾讯云对象存储 COS 的元信息(包括上传路径、上传签名等)。
  2. 该 API 在服务端上传位于哪个步骤请参考 服务端上传综述

SDK

建议使用 点播服务端 SDK 进行 API 的调用。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
videoType String 视频文件类型
videoName String 视频文件名称
coverType String 封面文件类型
coverName String 封面文件名称
sourceContext String 上传附带信息,在 事件通知-上传完成通知中可以根据该字段识别一次上传行为,参见事件通知
procedure String 视频后续任务操作,详见 任务流综述
videoStoragePath String 视频存储路径。APP可以自定义视频的目标存储路径,如:"/uin123345/20180109/1234.mp4",要求路径必须包含完整含文件名和后缀。参见 服务端上传指引
classId Integer 视频文件分类,默认为0
COMMON_PARAMS 参见 公共参数

请求示例

简单上传视频

https://vod.api.qcloud.com/v2/index.php?Action=ApplyUpload
&videoType=mp4
&COMMON_PARAMS

携带封面上传视频

https://vod.api.qcloud.com/v2/index.php?Action=ApplyUpload
&videoType=mp4&coverType=jpg
&COMMON_PARAMS

上传携带透传内容

https://vod.api.qcloud.com/v2/index.php?Action=ApplyUpload
&videoType=mp4&sourceContext=uin12345
&COMMON_PARAMS

上传后自动发起视频处理

https://vod.api.qcloud.com/v2/index.php?Action=ApplyUpload
&videoType=mp4&procedure=QCVB_ConvertAndReplace
&COMMON_PARAMS

上传指定视频分类

https://vod.api.qcloud.com/v2/index.php?Action=ApplyUpload
&videoType=mp4&classId=123
&COMMON_PARAMS

上传时自定义存储路径

https://vod.api.qcloud.com/v2/index.php?Action=ApplyUpload
&videoType=mp4&videoStoragePath=/uin12345/a.mp4
&COMMON_PARAMS

ALL IN ONE

https://vod.api.qcloud.com/v2/index.php?Action=ApplyUpload
&videoType=mp4&&coverType=jpg&&sourceContext=uin12345&procedure=QCVB_ConvertAndReplace&classId=123&videoStoragePath=/uin12345/a.mp4&
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码, 0: 成功, 其他值: 失败
message String 错误信息
video Array 使用 COS SDK 上传文件时需要的信息,具体参数见 CosUploadInfo。
cover Array 使用 COS SDK 上传文件时需要的信息,具体参数见 CosUploadInfo。
storageBucket String COS 上传使用的 bucket
storageRegion String COS 上传的地域
vodSessionKey String VOD 确认上传时使用的会话 Key

CosUploadInfo

参数名称 类型 描述
storagePath String COS 上传的目的路径

错误码说明

错误码 含义说明
4000 - 7000 参见 公共错误码
32001 服务内部错误

应答示例

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "video": {
        "storagePath": "/6c0f1c00vodgzp251000333/dee2156d24820810452266402/f0.mp4"
    },
    "cover": {
        "storagePath": "/6c0f1c00vodgzp251000333/dee2156d24820810452266402/24820810452266403.jpg"
    },
    "storageBucket": "6c0f1c00vodgzp251000333",
    "storageRegion": "gzp",
    "vodSessionKey": "3KEGq9DWHl1xF819mM4jVFkGn5WON80NwN/rTrx56UoEFApIV9DQ7t5m1g4hASR11gKWwGxkignB3AmhKOpUnym7wyNEHOwDJPcT5fBu66iCLcW7bhyRfDSsQcVpX0Wt96RKSsZFf62jeAB+e5640U8rMPV3Rf2eR+y1AgI+EC3JZU5iZbjLX4qNVI4RuLvLGcCUkYqWAYeqfHMYjvz0Fzhg6KuxnLicfs4D0gpyoX1X6gcsX8cWS0S0jCaZ+Q/r29IlU/w6E+UDFuk5yZik+whNxaZ/mOrctqr25jQ="
}