企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
客户联系
上传附件资源
上传附件资源
最后更新:2023/12/01
素材上传得到media_id,该media_id仅三天内有效
media_id在同一企业内应用之间可以共享

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/media/upload_attachment?access_token=ACCESS_TOKEN&media_type=TYPE&attachment_type=1

使用multipart/form-data POST上传文件, 文件标识名为"media"
参数说明:

参数必须说明
access_token调用接口凭证
media_type媒体文件类型,分别有图片(image)、视频(video)、普通文件(file)
attachment_type附件类型,不同的附件类型用于不同的场景。1:朋友圈;2:商品图册
注:朋友圈附件类型:如果是客户端jsapi或者小程序接口使用,仅支持企业微信客户端版本在4.0.2及以上版本使用。不然可能显示异常。

POST的请求包中,form-data中媒体文件标识,应包含有 filename、filelength、content-type等信息

filename标识文件展示的名称。比如,使用该media_id发消息时,展示的文件名由该字段控制
朋友圈附件类型,仅支持图片与视频

请求示例:

POST https://qyapi.weixin.qq.com/cgi-bin/media/upload_attachment?access_token=accesstoken001&media_type=TYPE&attachment_type=1  HTTP/1.1
Content-Type: multipart/form-data; boundary=-------------------------acebdf13572468
Content-Length: 220

---------------------------acebdf13572468
Content-Disposition: form-data; name="media";filename="wework.txt"; filelength=6
Content-Type: application/octet-stream

mytext
---------------------------acebdf13572468--

权限说明:
调用接口的应用需要满足如下的权限:

应用类型权限要求
自建应用配置到「客户联系 可调用接口的应用」中
代开发应用具有「企业客户」权限
第三方应用具有「企业客户」权限

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回数据:

{
   "errcode": 0,
   "errmsg": ""
   "type": "image",
   "media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
   "created_at": 1380000000
}

参数说明:

参数说明
type媒体文件类型,分别有图片(image)、语音(voice)、视频(video),普通文件(file)
media_id媒体文件上传后获取的唯一标识,三天有效,可使用获取临时素材接口获取
created_at媒体文件上传时间戳

上传的媒体文件限制

所有文件size必须大于5个字节

  • 图片(image):10MB,支持JPG,PNG格式。朋友圈类型图片,长边不超过10800像素,短边不超过1080像素。
  • 视频(video) :10MB,支持MP4格式。朋友圈类型视频时长不超过30秒
  • 文件(file) :10MB
注:目前 商品图册只支持图片类型; 朋友圈只支持图片、视频类型
上一篇管理聊天敏感词
下一篇获取已服务的外部联系人
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们