基础接口-上传下载多媒体文件

移动开发 Android
公众号在使用接口时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。通过本接口,公众号可以上传或下载多媒体文件。但请注意,每个多媒体文件(media_id)会在上传、用户发送到微信服务器3天后自动删除,以节省服务器资源。

公众号在使用接口时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。通过本接口,公众号可以上传或下载多媒体文件。但请注意,每个多媒体文件(media_id)会在上传、用户发送到微信服务器3天后自动删除,以节省服务器资源。

上传多媒体文件

公众号可调用本接口来上传图片、语音、视频等文件到微信服务器,上传后服务器会返回对应的media_id,公众号此后可根据该media_id来获取多媒体。请注意,media_id是可复用的,调用该接口需http协议。

接口调用请求说明

http请求方式: POST/FORM

http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

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

curl -F media=@test.jpg "http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

参数说明

返回说明

正确情况下的返回JSON数据包结果如下:

{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}

错误情况下的返回JSON数据包示例如下(示例为无效媒体类型错误):

{"errcode":40004,"errmsg":"invalid media type"}

注意事项

上传的多媒体文件有格式和大小限制,如下:

图片(image): 1M,支持JPG格式

语音(voice):2M,播放长度不超过60s,支持AMR\MP3格式

视频(video):10MB,支持MP4格式

缩略图(thumb):64KB,支持JPG格式

媒体文件在后台保存时间为3天,即3天后media_id失效。

使用网页调试工具调试该接口

下载多媒体文件

公众号可调用本接口来获取多媒体文件。请注意,视频文件不支持下载,调用该接口需http协议。

接口调用请求说明

http请求方式: GET

http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

请求示例(示例为通过curl命令获取多媒体文件)

curl -I -G "http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

参数说明

返回说明

正确情况下的返回HTTP头如下:

  1. HTTP/1.1 200 OK 
  2. Connection: close 
  3. Content-Type: image/jpeg 
  4. Content-disposition: attachment; filename="MEDIA_ID.jpg" 
  5. Date: Sun, 06 Jan 2013 10:20:18 GMT 
  6. Cache-Control: no-cache, must-revalidate 
  7. Content-Length: 339721 
  8. curl -G "http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_I 

错误情况下的返回JSON数据包示例如下(示例为无效媒体ID错误)::

{"errcode":40007,"errmsg":"invalid media_id"}

使用网页调试工具调试该接口

责任编辑:chenqingxiang
相关推荐

2009-07-07 13:45:04

jspsmart

2018-04-20 16:15:42

Koa2上传下载

2009-07-03 14:15:54

JSP SmartUp

2013-11-18 10:01:19

2020-02-14 12:56:56

Git多媒体文件开源

2009-07-30 13:43:58

ASP.NET中文件上

2014-09-24 11:04:31

微信企业号开发

2009-09-01 16:49:56

C#文件上传下载

2021-06-04 13:07:53

LinuxPythonXshell

2023-09-06 08:33:30

2010-03-08 11:34:45

Linux上传下载指令

2011-02-21 18:11:27

vsFTPd

2023-01-13 09:37:23

2009-07-02 13:31:13

JSP组件

2012-03-31 11:09:35

ibmdw

2010-01-14 15:06:27

CentOS用户

2013-04-10 18:24:48

微信公众平台接口开发

2013-08-28 16:08:19

多媒体Windows8.1

2023-05-07 07:45:31

2013-09-04 10:20:31

远程控制软
点赞
收藏

51CTO技术栈公众号