智能创作
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 智能创作 > 客户端 API > 上传相关接口 > 申请上传

申请上传

最近更新时间：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"
}

中国站