更新时间: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 | 域名不合法 |