User Guide
API (OId Version)
Calling Methods
Upload
Get Upload Token
Get Video Upload Token
Get Audio Upload Token
Get Material Upload Token
Normal Upload
File Upload Callback
Video Fetch
Asset MGMT
Video Processing
Video Playback
Appendix
API (New)
Tool and SDK

Get Video Upload Token

更新时间:2023-01-29 18:04:20

上传视频前,您需要先获取URL和凭据(令牌)。此 API 有助于为您获取上传视频的URL和凭据,还将生成视频 ID。

请求说明

项目 描述
请求方法 POST/GET
URL https://api.cloudv.haplat.net/vod/videoManage/getUploadToken
是否需要鉴权

建议您通过OpenAPI来调用该接口。 请求成功后, OpenAPI会自动为您生成代码片段。

请求参数

参数 类型 必填 描述
originFileName string 视频文件的名称,包括扩展名。例如,“uploadtest.mp4”。
fileId string 文件ID,最长32个字符。该参数将用于断点续传上传。断点续传只有在你指定了这个参数后才会起作用。
domain string 视频的播放域。
workflowId string 工作流 ID。您可以在云点播控制台上查看工作流ID, Preferences > Workflows > Workflow ID
注意:workflowId 将涵盖参数cmd、waterMarkName、transCodeCombineName 和subtitleId。
overwrite string 是否覆盖现有文件:
0–否
1–是
categoryNames string 视频类别,可以同时设置父类别和子类别。
例如,
[{“childName”:“child-category1”,“parentName”:“parent-category1”},{“ childName”:“child-category2”,“parentName”:“parent-category2”}]
waterMarkName string 水印。上传成功后会自动添加到视频中。
transCodeCombineName string 转码模板的名称。如果指定,则视频上传成功后将按照转码模板进行转码。
subtitleId string 字幕 ID。如果指定,字幕将添加到视频中。

响应参数

对于公共的响应参数,请访问公共响应参数

响应参数 类型 描述
fileKey string 上传文件的相对路径,不带域名和最前面的斜杠,例如“video/201704/245bbb46f2c1456ae076d2f131949999_1492507971/test.flv”。
uploadToken string 上传token(credential),将在后面的上传中用于身份验证。
uploadUrl string 文件上传的URL。该 URL 将在稍后的上传中使用。
videoId string 视频文件ID,上传完成后可用该ID查询视频的相关信息。
httpDnsServe string HTTP DNS 服务器地址。

例子

输入示例

curl -X POST 
  https://api.cloudv.haplat.net/vod/videoManage/getUploadToken 
  -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' 
  -H "Host: api.cloudv.haplat.net" 
  -H "Authorization: your token" 
  -H "X-WS-Timestamp: current timestamp" 
  -H "X-WS-AccessKey: your AccessKey ID" 
  -d 'originFileName=uploadtest.mp4'

输出示例

{
    "code": 200,
    "data": {
        "speedDomainlUrl": "",
        "bucketName": "iven-test-cloudv",
        "uploadUrl": "https://upload.cloudv.haplat.net",
        "uploadToken": "7e7dae54118c45a6ffd213a*****",
        "fileKey": "video/20230129/aea31e8fa8b441eba82ae0d0d900cf3b/555555554o90q7np55560365422q21os_62363dfef1a8446db77f4931a179a676.mp4",
        "httpDnsServer": "",
        "videoId": "fb67d77901851000ca2d54b900000000"
    },
    "message": "Operation successfully"
}

错误代码

以下仅列出了接口业务逻辑相关的错误码。对于常见错误,请参阅公共响应参数

错误代码 描述
1500 文件名已超过 40 个字符。
1604 文件MD5值不能为空。
1605 MD5 字符串长度过长。
1606 视频名称不能为空。
1607 视频源错误。
1608 参数覆盖既不是 0 也不是 1。
1609 视频大小只能是一个非负整数。
1610 视频大小已超出限制。
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!