更新时间:2022-09-15 17:03:42
获取视频上传令牌。
请求方式 | Post/get |
---|---|
接口地址 | https://open.chinanetcenter.com/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 | 否 | 上传策略,是否覆盖。 取值范围: |
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://open.chinanetcenter.com/vod/videoManage/getUploadToken
-H 'content-type: application/x-www-form-urlencoded; charset=utf-8'
-H "Host: open.chinanetcenter.com"
<公共的头部参数>
<自定义的头部参数>
-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 | 视频大小超出范围 |