申请上传

最近更新时间:2022-03-23 17:13:11

我的收藏

接口描述

接口名称:/Material/CreateUploadMaterial
接口功能:申请上传。

调用方式

具体调用方式参见 客户端 API 调用方式综述,您也可以使用 CME 客户端 API 调试工具 快速进行调试。

输入参数

字段
类型
必填
描述
ClassId
Integer
分类 ID。
MaterialType
String
素材类型,取值有:
VIDEO:视频。
AUDIO:音频。
IMAGE:图像。
STICKER:贴图。
EFFECT_VIDEO:效果素材。
Name
String
媒体名称。
Owner
媒体归属。
VerifySign
String
接口签名,具体签名计算参考签名算法

输出参数

接口输出参数由 公共返回参数 和接口自身返回参数两部分组成。接口自身返回参数详情如下。
字段
类型
描述
UploadContext
String
上传上下文。
VodUploadSign
String
上传签名。

示例

示例1:申请上传成功

申请上传媒体资源上传,成功返回签名。

输入示例

{
"ClassId": 1423,
"MaterialType": "VIDEO",
"Name": "上传测试",
"Owner": {
"Id": "ce4cdaf6-6039-486b-8f09-a5df23dbe6c9",
"Type": "PERSON"
},
"VerifySign": "jMGDoS3N7l+kmdsuh5o6B9MXVuxjdXJyZW50VGltZVN0YW1wPxxxxx"
}

输出示例

{
"Code": "Success",
"Message": "成功",
"EnglishMessage": "success",
"Data": {
"UploadContext": "xxxxxxxxxx",
"VodUploadSign": "xxxxxxxxxx"
}
}

示例2:申请上传失败

申请上传媒体资源上传到无访问权限的目录,返回权限不足。

输入示例

{
"ClassId": 1423,
"MaterialType": "VIDEO",
"Name": "上传测试",
"Owner": {
"Id": "ce4cdaf6-6039-486b-8f09-a5df23dbe6c9",
"Type": "PERSON"
},
"VerifySign": "jMGDoS3N7l+kmdsuh5o6B9MXVuxjdXJyZW50VGltZVN0YW1wPxxxxx"
}

输出示例

{
"Code": "OperationDenied.PermissionDeny",
"Message": "权限不足",
"EnglishMessage": "permission denied"
}