获取视频上传令牌
更新时间：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 | 视频大小超出范围 |
本篇文档内容对您是否有帮助？
有帮助
我要反馈