微信公众平台开发概述 微信开发者规范 微信公众号接口权限说明 微信公众号接口调用频次限制说明 微信开发者平台接入指南 微信公众平台 接口域名说明 微信公众平台 获取access_token 获取微信服务器IP地址 报警排查指引 接口测试号申请 自定义菜单创建接口 自定义菜单查询接口 自定义菜单删除接口 自定义菜单事件推送 个性化菜单接口 获取自定义菜单配置接口 接收普通消息 接收事件推送 被动回复用户消息 消息加解密说明 客服消息 高级群发接口 模板消息接口 模板消息运营规范 获取公众号的自动回复规则 微信网页授权 微信网页开发样式库 微信JS-SDK说明文档 微信web开发者工具 新增临时素材 获取临时素材 新增永久素材 删除永久素材 修改永久图文素材 获取素材总数 获取素材列表 用户标签管理 设置用户备注名 获取用户基本信息(UnionID机制) 获取用户列表 获取用户地理位置 黑名单管理 生成带参数的二维码 长链接转短链接接口 微信认证事件推送 用户分析数据接口 图文分析数据接口 消息分析数据接口 接口分析数据接口 微信卡券接口 创建卡券 投放卡券 核销卡券 管理卡券 卡券事件推送 会员卡专区(一) 会员卡专区(二) 朋友的券专区 特殊票券 第三方开发者模式 卡券错误码 微信门店接口 微信小店接口 语义理解接口 微信服务号设备功能介绍 如何新增产品型号 将消息转发到微信客服 微信客服管理 微信会话控制 微信获取聊天记录 申请开通微信摇一摇 微信设备ID 微信摇一摇页面管理 微信摇一摇上传图片素材 管理设备与页面的关联关系 微信摇一摇数据统计 摇一摇关注的JSAPI 摇一摇事件通知 html5页面获取设备信息 微信摇一摇获取设备及用户信息 摇一摇红包介绍说明 摇一摇周边错误码 微信连Wi-Fi开发者指引 Wi-Fi硬件鉴权协议接口说明 Wi-Fi软件服务管理接口说明 开通微信连Wi-Fi插件 Wi-Fi门店管理 Wi-Fi设备管理 配置微信WiFi联网方式 微信商家主页管理 Wi-Fi数据统计 连网后下发消息 微信卡券投放 微信Wi-Fi接口返回错误码 微信连网过程常见错误码 微信扫一扫接入指南 微信上进行商品创建 微信商品发布 微信商品管理 扫一扫事件推送 一物一码专区 扫一扫错误码 在线帮助工具

微信门店

微信公众平台开发者文档

浏览43355
更新时间2022-04-11

新增临时素材

1474938506730644.png

公众号经常有需要用到一些临时性的多媒体素材的场景,例如在使用接口特别是发送消息时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。素材管理接口对所有认证的订阅号和服务号开放。通过本接口,公众号可以新增临时素材(即上传临时多媒体文件)。

请注意:

1、对于临时素材,每个素材(media_id)会在开发者上传或粉丝发送到微信服务器3天后自动删除(所以用户发送给开发者的素材,若开发者需要,应尽快下载到本地),以节省服务器资源。

2、media_id是可复用的。

3、素材的格式大小等要求与公众平台官网一致。具体是,图片大小不超过2M,支持png/jpeg/jpg/gif格式,语音大小不超过5M,长度不超过60秒,支持mp3/amr格式

4、需使用https调用本接口。

本接口即为原“上传多媒体文件”接口。

接口调用请求说明

http请求方式: POST/FORM,需使用https

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

调用示例(使用curl命令,用FORM表单方式上传一个多媒体文件):
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

参数说明

参数 是否必须 说明
access_token 调用接口凭证
type


媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb)
media form-data中媒体文件标识,有filename、filelength、content-type等信息

返回说明

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

{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
参数 描述
type 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb,主要用于视频与音乐格式的缩略图)
media_id 媒体文件上传后,获取时的唯一标识
created_at 媒体文件上传时间戳

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

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

注意事项

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

    图片(image): 2M,支持PNG\JPEG\JPG\GIF格式

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

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

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

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

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

相关视频

更多

免费

php8,我来也
初级php8,我来也

34万次学习

收藏

免费

Thinkphp6.0正式版视频教程
中级Thinkphp6.0正式版视频教程

39.6万次学习

收藏

免费

细说PHP第一季
中级细说PHP第一季

31万次学习

收藏

精品课程

更多
前端入门_HTML5
前端入门_HTML5

共29课时

64.9万人学习

CSS视频教程-玉女心经版
CSS视频教程-玉女心经版

共25课时

41.2万人学习

JavaScript极速入门_玉女心经系列
JavaScript极速入门_玉女心经系列

共43课时

76.6万人学习

独孤九贱(1)_HTML5视频教程
独孤九贱(1)_HTML5视频教程

共25课时

64.1万人学习

独孤九贱(2)_CSS视频教程
独孤九贱(2)_CSS视频教程

共22课时

24.3万人学习

独孤九贱(3)_JavaScript视频教程
独孤九贱(3)_JavaScript视频教程

共28课时

36.2万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时

133.1万人学习

热门下载

更多
phpStudy 2018最新版
phpStudy 2018最新版

集成PHP7,16种组合,超全大合集

下载

VC9 32位
VC9 32位

VC9 32位 phpstudy集成安装环境运行库

下载

VC11 32位
VC11 32位

VC11 32位 phpstudy集成安装环境运行库​

下载

php程序员工具箱完整版
php程序员工具箱完整版

程序员工具箱 v1.0 php集成环境

下载

VC14 32位
VC14 32位

VC14 32位 phpstudy安装环境运行库

下载

SublimeText3汉化版
SublimeText3汉化版

中文版,非常好用

下载

Notepad++ Windows版
Notepad++ Windows版

Notepad++ 8.9.7 Windows版官方安装包,适合 Windows 用户进行代码编辑、文本处理、语法高亮和插件扩展配置。

下载