首页 > 开发指南 > 素材管理
上传素材文件
更新时间: 2021-12-08 10:40:26

素材管理

通过素材管理的接口,企业可以上传下载或删除多媒体文件, 目前支持的是CRM素材和图文消息素材管理,对素材的获取和调用等操作,是通过mediaId来进行的

1.上传CRM素材文件

调用示例(使用curl命令,用FORM表单方式上传一个多媒体文件):

curl -F "media=@test.jpg" http://open.71360.com/media/upload?corpAccessToken=xxx&corpId=xxx&type=image

请求说明

请求方式:post+multipart/form-data 方式

请求路径:https://open.71360.com/media/upload


上传的文件限制:

  1. image类型,最大20M,支持jpg, png, gif, bmp, jpeg格式

  2. document类型,最大100M

请注意,mediaId是可复用的,同一个mediaId可用于CRM对象的图片、文件类型字段

参数说明

参数参数类型必须说明
corpAccessTokenString企业应用访问公司合法性凭证
corpIdString开放平台公司帐号
type
String素材文件类型,目前支持image(CRM素材), document(文档类型,支持审批素材CRM素材)
media
二进制流form-data中媒体文件标识,有filename、filelength、content-type等信息

返回说明

参数必须说明
errorCode返回码
errorMessage对返回码的文本描述内容
mediaId素材ID

a) 正确的JSON返回结果示例:

{
    "errorCode": 0,
    "errorMessage": "success",
    "mediaId": "MEDIA_ID"
}

b) 错误的JSON返回示例:

{
    "errorCode": 10013,
    "errorMessage": "the parameter corpAccessToken is missing"
}


2.上传消息素材文件

调用示例(使用curl命令,用FORM表单方式上传一个多媒体文件):

curl -F "media=@test.jpg" http://open.71360.com/media/upload/message?corpAccessToken=xxx&corpId=xxx

请求说明

请求方式:post+multipart/form-data 方式

请求路径:https://open.71360.com/media/upload/message

上传的文件限制:

   图片文件,最大5M,支持jpg, png, gif, bmp, jpeg格式,用于发送消息接口


请注意,mediaId是可复用的,同一个mediaId可用于图文消息的多次发送。

参数说明

参数参数类型必须说明
corpAccessTokenString企业应用访问公司合法性凭证
corpIdString开放平台公司帐号
media
二进制流form-data中媒体文件标识,有filename、filelength、content-type等信息

返回说明

参数必须说明
errorCode返回码
errorMessage对返回码的文本描述内容
mediaId素材ID

a) 正确的JSON返回结果示例:

{
    "errorCode": 0,
    "errorMessage": "success",
    "mediaId": "MEDIA_ID"
}

b) 错误的JSON返回示例:

{
    "errorCode": 10013,
    "errorMessage": "the parameter corpAccessToken is missing"
}