获取素材上传令牌
更新时间：2022-09-15 17:03:43
获取素材上传令牌接口
描述
获取素材上传令牌。
请求说明
| 请求方式 | Post |
|---|---|
| 接口地址 | https://open.chinanetcenter.com/vod/material/getMaterialUploadToken |
| Content-Type | 仅支持application/json |
| 鉴权方式 | 鉴权方式V3 |
请求参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| fileList | array | 是 | 需要获取上传令牌的文档列表（参数包含name、suffix），最多一次性获取50个 例：[{“name”:“fileName1”,“suffix”:“jpg”},{“name”:“fileName2”,“suffix”:“jpg”}] |
| domain | string | 否 | 素材域名，如果不填或为空，则设为默认素材域名。如果域名不存在，返回错误。不带http://或https://，例：xxx.com |
| overwrite | boolean | 否 | 上传策略，是否覆盖。默认为false |
其中fileList数组元素的数据结构如下：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 上传文件名， 长度最多不能超过40个字符 |
| suffix | string | 否 | 文件后缀 |
返回参数
通用返回结果详见返回结果
成功时返回的data参数的数据结构
| 参数名 | 类型 | 描述 |
|---|---|---|
| uploadUrl | string | 上传url地址 |
| bucketName | string | 要上传的WCS的bucket名称 |
| items | array | 具体token信息 |
items数组元素的数据结构
| 参数名 | 类型 | 描述 |
|---|---|---|
| name | string | 文件名 |
| suffix | string | 文件后缀 |
| materialId | string | 素材id |
| uploadToken | string | 上传token |
| fileFullUrl | string | 文件路径 |
示例
输入示例
curl -X POST
http://open.chinanetcenter.com/vod/materialManage/getMaterialUploadToken
-H 'content-type: application/json'
-H "Host: open.chinanetcenter.com"
<公共的头部参数>
<自定义的头部参数>
-d '{"fileList":[{"name":"test01","suffix":"jpg"},{"name":"test02","suffix":"jpeg"}],domain=xxxx.com,overwrite=false}'
注意：示例中的“公共参数”参见公共参数说明文档。
输出示例
{
"code": 200,
"data": {
"bucketName": "ovptest",
"items": [
{
"fileFullUrl": "ovptest:cloudv-material/20200629/feb8ec8801721000b3c0f2f500000000.jpg",
"materialId": "feb8ec880172100060d1cff500000000",
"name": "test01.",
"suffix": "jpg",
"uploadToken": "7e7dae54118c45a6ffd213a18c9d4847b51a73f1:NzNiZjc2NzRkYjUzMTk0NDY4NDhiNGY2N2YxMjVlOWNjZjBjMjBiYg==:eyJzY29wZSI6Im92cHRlc3Q6Y2xvdWR2LW1hdGVyaWFsLzIwMjAwNjI5L2ZlYjhlYzg4MDE3MjEwMDBiM2MwZjJmNTAwMDAwMDAwLmpwZyIsImRlYWRsaW5lIjoiOTIyMzM3MjAzNjg1NDc3NTgwNyIsIm92ZXJ3cml0ZSI6MCwiZnNpemVMaW1pdCI6MCwiY2FsbGJhY2tVcmwiOiJodHRwOi8vY2FsbGJhY2tkZXYub3ZwdGVzdC5oYXBsYXQubmV0L2NhbGxiYWNrL2NhbGxiYWNrIW1hdGVyaWFsVXBsb2FkQ2FsbGJhY2suYWN0aW9uIiwiY2FsbGJhY2tCb2R5IjoiJmtleT0kKGtleSkmZm5hbWU9dGVzdDAxLmpwZyZmc2l6ZT0kKGZzaXplKSZtaW1lVHlwZT0kKG1pbWVUeXBlKSZ1cmw9JCh1cmwpJm1hdGVyaWFsSWQ9ZmViOGVjODgwMTcyMTAwMDYwZDFjZmY1MDAwMDAwMDAmdXNlck5hbWU9b3ZwdGVzdCZkb21haW5JZD04MzA1In0="
},
{
"fileFullUrl": "ovptest:cloudv-material/20200629/feb8eca801721000462961b400000000.jpeg",
"materialId": "feb8eca8017210001ddc3b3900000000",
"name": "test02.",
"suffix": "jpeg",
"uploadToken": "7e7dae54118c45a6ffd213a18c9d4847b51a73f1:MWU4NWM3YWIxOWUwN2MyYmIwYTNkMjdlYjQzMjQxMDg4NjAzZjE1Yg==:eyJzY29wZSI6Im92cHRlc3Q6Y2xvdWR2LW1hdGVyaWFsLzIwMjAwNjI5L2ZlYjhlY2E4MDE3MjEwMDA0NjI5NjFiNDAwMDAwMDAwLmpwZWciLCJkZWFkbGluZSI6IjkyMjMzNzIwMzY4NTQ3NzU4MDciLCJvdmVyd3JpdGUiOjAsImZzaXplTGltaXQiOjAsImNhbGxiYWNrVXJsIjoiaHR0cDovL2NhbGxiYWNrZGV2Lm92cHRlc3QuaGFwbGF0Lm5ldC9jYWxsYmFjay9jYWxsYmFjayFtYXRlcmlhbFVwbG9hZENhbGxiYWNrLmFjdGlvbiIsImNhbGxiYWNrQm9keSI6IiZrZXk9JChrZXkpJmZuYW1lPXRlc3QwMi5qcGVnJmZzaXplPSQoZnNpemUpJm1pbWVUeXBlPSQobWltZVR5cGUpJnVybD0kKHVybCkmbWF0ZXJpYWxJZD1mZWI4ZWNhODAxNzIxMDAwMWRkYzNiMzkwMDAwMDAwMCZ1c2VyTmFtZT1vdnB0ZXN0JmRvbWFpbklkPTgzMDUifQ=="
}
],
"uploadUrl": "https://upload.cloudv.haplat.net"
},
"message": "操作成功"
}
错误码
以下仅列出了接口业务逻辑相关的错误码，通用错误码详见 返回结果
| 错误码 | 描述 |
|---|---|
| 1301 | 用户无权限 |
| 1004 | 参数错误,请确保所有必填项都已经填写 |
| 1000 | 文件列表不合法 |
| 1000 | 素材后缀超出长度范围 |
| 1000 | 域名不合法 |
本篇文档内容对您是否有帮助？
有帮助
我要反馈