获取视频上传令牌-文档中心

POSTGET

https://api.cdnetworks.com/vod/videoManage/getUploadToken

调用getUploadToken获取视频文件上传地址和凭证

单用户调用频率：300/5min
适用产品：云点播

API鉴权说明详见：API鉴权概览

请求参数

Body 参数

参数名称	描述
*originFileNameString	上传文件名，包含文件格式
fileIdString	文件ID，最长32位的任意字符串。用于断点续传，如果不传则不支持断点续传功能。
fileMd5String	文件的md5值，即将弃用，使用fileId代替
domainString	视频发布域名，若不传，则以视频管理默认域名作为本视频的发布域名，可通过云点播控制台>全局配置>默认域名设置默认域名
workflowIdString	工作流ID，workflowId会覆盖cmd、waterMarkName、transCodeCombineName、subtitleId
overwriteInteger	上传策略，是否覆盖。取值范围： 0(否) 1(是)
categoryNamesString	视频分类，可指定父分类和子分类。如：[{"childName":"子分类1","parentName":"父分类1"},{"childName":"子分类2","parentName":"父分类2"}]
waterMarkNameString	水印名,上传成功后会自动转码增加水印
transCodeCombineNameString	转码组合名,上传成功后会自动转码增加清晰度
subtitleIdString	字幕ID ,对应云点播素材管理的素材ID。上传成功后会自动转码增加字幕；仅支持ass或srt字幕格式。
subtitleString	支持多个字幕，最多可以添加13个字幕。只支持多码率自适应转码。仅支持vtt字幕格式。格式内容为： lang：字幕code，可以根据自己需求定义 subtitleId：字幕ID，对应云点播素材管理的素材ID code[{"lang":"cn","subtitleId":"8a36dfe101921000368ac14400000000"},{"lang":"en-US","subtitleId":"8a38e428019210004d56ef8c00000000"},{"lang":"ko","subtitleId":"8a36dfe101921000368ac14400000000"}] 的base64加密控制台播放器字幕语言对应code。语言 code 中文：cn 英文：en-US 日文:ja 繁体中文:zh-tw 法语:fr 德语:de 西班牙语:es 葡萄牙语:pt 俄语:ru 韩语:ko 泰语:th 越南语:vt 印尼语:id

返回参数

Body 参数

参数名称	描述
codeInteger	创建结果状态码，200为成功
messageString	返回消息
- dataObject	返回数据
uploadUrlString	上传域名地址
fileKeyString	上传文件的相对路径，不带域名和最前面的斜杠
httpDnsServerString	HttpDns服务器地址
videoIdString	视频ID，上传完成后可通过该ID查询该视频相关信息
uploadTokenString	上传token
speedDomainlUrlString	【计划弃用】上传加速域名地址
bucketNameString	空间名称

错误码

错误代码（code）	描述（message）	HTTP状态码	语义
1500	The video name is more than 40 characters long	200	视频名称,超过40个字符
1604	The MD5 value of the file cannot be empty	200	文件MD5值不能为空
1605	The MD5 value of the file is too long. Procedure	200	文件MD5值长度过长
1606	The video name cannot be empty	200	视频名称不能为空
1607	Video source error	200	视频来源错误
1608	The overwrite policy value can only be 0 or 1	200	覆盖策略值只能为0或1
1609	Video size can only be a non-negative integer	200	视频大小只能为非负整数
1610	The video size is out of range	200	视频大小超出范围

示例

JSON

请求示例 复制代码 复制成功#!/bin/bash username='example_username' apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/vod/videoManage/getUploadToken" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "x-cnc-auth-method: BASIC" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "originFileName": "test.mp4", "fileId":"XXXXXX", "domain":"xxxx.com", "workflowId":"XXXXXX", "categoryNames":"category1", "waterMarkName":"waterMark1", "transCodeCombineName":"transCodeCombine1", "subtitleId":"XXXXXX", "overwrite":"0" }'

#!/bin/bash
username='example_username'
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/vod/videoManage/getUploadToken" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "x-cnc-auth-method: BASIC" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
    "originFileName": "test.mp4",
    "fileId":"XXXXXX",
    "domain":"xxxx.com",
    "workflowId":"XXXXXX",
    "categoryNames":"category1",
    "waterMarkName":"waterMark1",
    "transCodeCombineName":"transCodeCombine1",
    "subtitleId":"XXXXXX",
    "overwrite":"0"
}'

返回示例 复制代码 复制成功{ "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": "Operation succeeded" }

{
	"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": "Operation succeeded"
}

本篇文档内容对您是否有帮助？

有帮助

我要反馈

获取视频上传令牌

请求参数

Body 参数

返回参数

Body 参数

错误码

示例

目录