企业在使用接口时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。通过本接口,企业可以上传或下载多媒体文件。
注意,每个多媒体文件(media_id)会在上传到微信服务器3天后自动删除,以节省服务器资源。
一、上传媒体文件
用于上传图片、语音、视频等媒体资源文件以及普通文件(如doc,ppt),接口返回媒体资源标识ID:media_id。请注意,media_id是可复用的,同一个media_id可用于消息的多次发送。
- 请求说明
Https请求方式: POST
https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
- 参数说明
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
type | 是 | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video),普通文件(file) |
media | 是 | form-data中媒体文件标识,有filename、filelength、content-type等信息 |
- 权限说明
完全公开。所有管理员均可调用,media_id可以共享。
- 返回说明
- {
- "type": "image",
- "media_id": "0000001",
- "created_at": "1380000000"
- }
参数 | 说明 |
---|---|
type | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video),普通文件(file) |
media_id | 媒体文件上传后获取的***标识 |
created_at | 媒体文件上传时间戳 |
- 上传的媒体文件限制
图片(image):1MB,支持JPG格式
语音(voice):2MB,播放长度不超过60s,支持AMR格式
视频(video):10MB,支持MP4格式
普通文件(file):10MB
二、获取媒体文件
通过media_id获取图片、语音、视频等文件。
- 请求说明
Https请求方式: GET
https://qyapi.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
- 参数说明
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
media_id | 是 | 媒体文件id |
- 权限说明
完全公开。所有管理员均可调用,media_id可以共享。
- 返回结果
a)正确时返回:
- {
- HTTP/1.1 200 OK
- Connection: close
- Content-Type: image/jpeg
- Content-disposition: attachment; filename="MEDIA_ID.jpg"
- Date: Sun, 06 Jan 2013 10:20:18 GMT
- Cache-Control: no-cache, must-revalidate
- Content-Length: 339721
- Xxxx
- }
b)错误时返回(这里省略了HTTP首部):
- {
- "errcode": "40004",
- "errmsg": "invalid media_id"
- }