微信企业号开发之如何管理多媒体文件

企业在使用接口时，对多媒体文件、多媒体消息的获取和调用等操作，是通过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" 
}