CDN加速

获取视频上传令牌

更新时间:2021-01-27 16:08:55

描述

获取视频上传令牌。

请求说明

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

请求参数

参数名 类型 是否必填 描述
originFileName string       是       上传文件名,包含文件格式
fileId string 文件ID,最长32位的任意字符串。用于
断点续传,如果不传则不支持断点续传
功能。
fileMd5 string 文件的md5值,即将弃用,使用fileId
代替
domain string 视频发布域名,若不传,则以视频管理
默认域名作为本视频的发布域名,可通
云点播控制台>全局配置>默认域名
设置默认域名
workflowId string 工作流ID,workflowId会覆盖cmd、waterMarkName、transCodeCombineName、subtitleId
overwrite string 上传策略,是否覆盖。
取值范围:
  • 0(否)
  • 1(是)

  • categoryNames string 视频分类,可指定父分类和子分类。如:[{“childName”:“子分类1”,“parentName”:“父分类1”},{“childName”:“子分类2”,“parentName”:“父分类2”}]
    waterMarkName string 水印名,上传成功后会自动转码增加水印
    transCodeCombineName string 转码组合名,上传成功后会自动转码增加清晰度
    subtitleId string 字幕ID ,转码组合名,上传成功后会自动转码增加字幕

    返回参数

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

    参数名 类型 描述
    fileKey string 上传文件的相对路径,不带域名和最前面的斜杠
    uploadToken string 上传token
    uploadUrl string 上传域名地址
    videoId string 视频ID,上传完成后可通过该ID查询该视频相关信息
    httpDnsServe string HttpDns服务器地址

    示例

    输入示例

    
    curl -X POST 
      http://api.cloudv.haplat.net/vod/videoManage/getUploadToken 
      -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' 
      -H "Host: api.cloudv.haplat.net" 
      <公共的头部参数>
      <自定义的头部参数>
      -d 'fileMd5=test.streampull.live&originFileSize =123&filePath=video&originFileId=o_1bdlsdve81iup13mq1npoc1rngfc&originFileName=test&overwrite=1&videoSource=web&cmd=W3sid29ya2Zsb3dDb2RlIjoiVklERU9fRlJBTUUiLCJwYXJhbXMiOiJ7XCJoXCI6MTAwLFwiaW50ZXJ2YWxcIjo0LFwiblwiOjEwLFwibm90aWZ5VXJsXCI6XCJodHRwOi8vdGVzdC5jb21cIixcIm9mZnNldFwiOm51bGwsIFwid1wiOjEwMH0ifSx7IndvcmtmbG93Q29kZSI6IkFVVE9fVFJBTlNfQ09ERSIsInBhcmFtcyI6IntcIm5vdGlmeVVybFwiOlwiaHR0cDp0ZXN0LmNvbVwiLFwid2F0ZXJtYXJrTmFtZVwiOlwi5rC05Y2w5rWL6K+VXCIsXCJ0cmFuc2NvZGVDb21iaW5lTmFtZVwiOlwi6L2s56CB57uE5ZCI5rWL6K+VXCIsXCJzdWJ0aXRsZUlkXCI6XCIyZTUzNTljZjAxNmExMDAwMWU2MzhkZTAwMDAwMDAwMFwifSx7Im5vdGlmeVVybCI6Imh0dHA6Ly90ZXN0LmNvbSIsIndvcmtmbG93Q29kZSI6IlVQTE9BRF9OT1RJRlkifV0=’
    
    

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

    输出示例

    {
    "code": 200,
    "data": {
    "fileKey": "video/201704/245bbb46f2c1456ae076d2f131949999_1492507971/test.flv",
    "httpDnsServer": "https://sdkoptedge.chinanetcenter.com",
    "uploadToken": "7e7dae54118c45a6ffd213a18c9d4847b51a73f1:NmVlZGVhMDNkYTMzMDY2MWE2ODU2Yjg1NjNlYTNkNTU0YmUyZmZiOA==:eyJzY29wZSI6Im92cHRlc3Q6dmlkZW8vMjAxNzA0LzI0NWJiYjQ2ZjJjMTQ1NmFlMDc2ZDJmMTMxOTQ5OTk5XzE0OTI1MDc5NzEvdGVzdCIsImRlYWRsaW5lIjoiMjUyNDYyMjQwMDAwMCIsIm92ZXJ3cml0ZSI6MCwiZnNpemVMaW1pdCI6MCwiY2FsbGJhY2tVcmwiOiJodHRwOi8vMTIwLjQxLjMuNDU6OTA4MS9jYWxsYmFjay9jYWxsYmFjayF1cGxvYWRDYWxsYmFjay5hY3Rpb24iLCJjYWxsYmFja0JvZHkiOiImYnVja2V0PSQoYnVja2V0KSZrZXk9JChrZXkpJmZuYW1lPSQoZm5hbWUpJmZzaXplPSQoZnNpemUpJm1pbWVUeXBlPSQobWltZVR5cGUpJnVybD0kKHVybCkmaXA9JChpcCkmY29zdFRpbWU9JChjb3N0VGltZSkmYXZpbmZvPSQoYXZpbmZvKSJ9",
    "uploadUrl": "http://ovptest.up2.v1.wcsapi.com",
    "videoId": "4B8F584A572B15712998422C3363177D",
      },
    "message": "操作成功"
    }
    
    

    错误码

    以下仅列出了接口业务逻辑相关的错误码,通用错误码详见 返回结果

    错误码 描述
    1500 视频名称,超过40个字符
    1604 文件MD5值不能为空
    1605 文件MD5值长度过长
    1606 视频名称不能为空
    1607 视频来源错误
    1608 覆盖策略值只能为0或1
    1609 视频大小只能为非负整数
    1610 视频大小超出范围