Get Video Upload Token_API (OId Version)

上传视频前，您需要先获取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	视频大小已超出限制。

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

Get Video Upload Token

请求说明

请求参数

响应参数

例子

输入示例

输出示例

错误代码

目录