简体中文
上传CRM素材文件
约 365 字大约 1 分钟
2026-01-16
描述
上传CRM素材文件
请求说明
请求方式:POST + application/json
请求路径:https://${填入所在云的域名}/media/upload?thirdTraceId=${随机字符串}
请求头填写 :参考公共参数填写
调用示例(使用curl命令,用FORM表单方式上传一个多媒体文件): curl -F "media=@test.jpg" http://open.fxiaoke.com/media/upload?corpAccessToken=xxx&corpId=xxx&type=image
上传的文件限制:
image类型,最大20M,支持jpg, png, gif, bmp, jpeg格式
document类型,最大100M
请注意,mediaId是可复用的,同一个mediaId可用于CRM对象的图片、文件类型字段。
请求参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| type | String | 是 | 素材文件类型,目前支持image(CRM素材), document(文档类型,支持审批素材, CRM素材) |
| igonreMediaIdConvert | Boolean | 是 | mediaId类型,当为true时返回值中的mediaId值为npath;当为false时返回值中的mediaId为mediaId;上传和下载应设置为同一值(推荐传值true) |
| media | 是 | 二进制流,包含form-data中媒体文件标识,有filename、filelength、content-type等信息 |
请求示例
{
"media": "hello",
"type": 1,
"igonreMediaIdConvert": 1
}返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| traceId | string | 请求唯一ID |
| errorDescription | string | 错误描述 |
| errorMessage | string | 错误信息 |
| errorCode | Int | 查看错误码 |
返回示例
{
"traceId": "E-O.827xxxxxx",
"errorDescription": "success",
"errorMessage": "OK",
"errorCode": 0
}注意事项
- 不能使用返回值的message字段做逻辑判断,errorMessage会有变化;
