CDN加速

获取素材上传令牌

更新时间:2021-01-27 16:08:51

获取素材上传令牌接口

描述

获取素材上传令牌。

请求说明

请求方式 Post
接口地址 https://api.cloudv.haplat.net/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://api.cloudv.haplat.net/vod/materialManage/getMaterialUploadToken 
  -H 'content-type: application/json' 
  -H "Host: api.cloudv.haplat.net" 
  <公共的头部参数>
  <自定义的头部参数> 
  -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 域名不合法