发起视频上传

最近更新时间:2019-07-09 10:52:42

接口名称

ApplyUpload

功能说明

  • 发起视频(或封面)文件的上传,获取文件上传到对象存储 COS 的元信息(包括上传路径和上传签名等)。
  • API 在服务端上传的具体步骤请参见 服务端上传综述
  • 推荐使用 云点播服务端 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
  • 综合示例

    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="
}