第三方平台可以通过微信公众平台素材管理接口实现同步了

  平时运营微信公众平台时有没发现素材管理有点不太好操作,特别是素材一多,找个东西都翻半天。现在好了,微信宣布公众平台新增素材管理接口,对所有认证公众号开放,方便快捷,可以实现同步互通。(4.29更新第三方平台也能为未微信认证的订阅号调用自定义菜单接口和素材管理接口)

  微信公众平台素材管理接口具体如下:

  1. 新增临时素材 公众号经常有需要用到一些临时性的多媒体素材的场景,例如在使用接口特别是发送消息时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。素材管理接口对所有认证的订阅号和服务号开放。 通过本接口,公众号可以新增临时素材(即上传临时多媒体文件)。但请注意,每个多媒体文件(media_id)会在开发者上传或粉丝发送到微信服务器3天后自动删除(所以用户发送给开发者的素材,若开发者需要,应尽快下载到本地),以节省服务器资源。请注意,media_id是可复用的。 本接口即为原“上传多媒体文件”接口。 接口调用请求说明 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): 1M,支持JPG格式
    • 语音(voice):2M,播放长度不超过60s,支持AMR\MP3格式
    • 视频(video):10MB,支持MP4格式
    • 缩略图(thumb):64KB,支持JPG格式

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

  2. 获取临时素材 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件)。请注意,视频文件不支持https下载,调用该接口需http协议。 本接口即为原“下载多媒体文件”接口。 接口调用请求说明 http请求方式: GET,https调用 https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID 请求示例(示例为通过curl命令获取多媒体文件) curl -I -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID" 参数说明 参数是否必须说明 access_token 是 调用接口凭证 media_id 是 媒体文件ID 返回说明 正确情况下的返回HTTP头如下: 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 curl -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID" 错误情况下的返回JSON数据包示例如下(示例为无效媒体ID错误):: {"errcode":40007,"errmsg":"invalid media_id"}
  3. 新增永久素材 除了3天就会失效的临时素材外,开发者有时需要永久保存一些素材,届时就可以通过本接口新增永久素材。 请注意: 1、新增的永久素材也可以在公众平台官网素材管理模块中看到 2、永久素材的数量是有上限的,请谨慎新增。图文消息素材和图片素材的上限为5000,其他类型为1000 3、调用该接口需https协议 新增永久图文素材 接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN 调用示例 { "articles": [{ "title": TITLE, "thumb_media_id": THUMB_MEDIA_ID, "author": AUTHOR, "digest": DIGEST, "show_cover_pic": SHOW_COVER_PIC(0 / 1), "content": CONTENT, "content_source_url": CONTENT_SOURCE_URL }, //若新增的是多图文素材,则此处应还有几段articles结构 ] } 参数说明 参数是否必须说明 title 是 标题 thumb_media_id 是 图文消息的封面图片素材id(必须是永久mediaID) author 是 作者 digest 是 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空 show_cover_pic 是 是否显示封面,0为false,即不显示,1为true,即显示 content 是 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS content_source_url 是 图文消息的原文地址,即点击“阅读原文”后的URL 返回说明 { "media_id":MEDIA_ID } 返回的即为新增的图文消息素材的media_id。 新增其他类型永久素材 接口调用请求说明 通过POST表单来调用接口,表单id为media,包含需要上传的素材内容,有filename、filelength、content-type等信息。请注意:图片素材将进入公众平台官网素材管理模块中的默认分组。 http请求方式: POST http://file.api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN 调用示例(使用curl命令,用FORM表单方式新增一个其他类型的永久素材): curl -F media=@test.jpg "http://file.api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN" 参数说明 参数是否必须说明 access_token 是 调用接口凭证 type 是 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb) media 是 form-data中媒体文件标识,有filename、filelength、content-type等信息 新增永久视频素材需特别注意 在上传视频素材时需要POST另一个表单,id为description,包含素材的描述信息,内容格式为JSON,格式如下: { "title":VIDEO_TITLE, "introduction":INTRODUCTION } 新增永久视频素材的调用示例: curl "http://file.api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN" -F media=@media.file -F description='{"title":VIDEO_TITLE, "introduction":INTRODUCTION}' 参数说明 参数是否必须说明 title 是 视频素材的标题 introduction 是 视频素材的描述 返回说明 { "media_id":MEDIA_ID } 返回参数说明 参数描述 media_id 新增的永久素材的media_id 错误情况下的返回JSON数据包示例如下(示例为无效媒体类型错误): {"errcode":40007,"errmsg":"invalid media_id"}
  4. 获取永久素材 在新增了永久素材后,开发者可以根据media_id来获取永久素材,需要时也可保存到本地。 请注意: 1、获取永久素材也可以获取公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材(但需要先通过获取素材列表来获知素材的media_id) 2、临时素材无法通过本接口获取 3、调用该接口需https协议 接口调用请求说明 http请求方式: POST,https调用 https://api.weixin.qq.com/cgi-bin/material/get_material?access_token=ACCESS_TOKEN 调用示例 { "media_id":MEDIA_ID } 参数说明 参数是否必须说明 access_token 是 调用接口凭证 media_id 是 要获取的素材的media_id 返回说明 如果请求的素材为图文消息,则响应如下: { "news_item": [ { "title":TITLE, "thumb_media_id"::THUMB_MEDIA_ID, "show_cover_pic":SHOW_COVER_PIC(0/1), "author":AUTHOR, "digest":DIGEST, "content":CONTENT, "content_source_url":CONTENT_SOURCE_URL }, //多图文消息有多篇文章 ] } 其他类型的素材消息,则响应的直接为素材的内容,开发者可以自行保存为文件。例如: 示例 curl "https://api.weixin.qq.com/cgi-bin/material/get_material?access_token=ACCESS_TOKEN" -d '{"media_id":"61224425"}' > file 返回参数说明 参数描述 title 图文消息的标题 thumb_media_id 图文消息的封面图片素材id(必须是永久mediaID) show_cover_pic 是否显示封面,0为false,即不显示,1为true,即显示 author 作者 digest 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空 content 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS content_source_url 图文消息的原文地址,即点击“阅读原文”后的URL 错误情况下的返回JSON数据包示例如下(示例为无效媒体类型错误): {"errcode":40007,"errmsg":"invalid media_id"}
  5. 删除永久素材 在新增了永久素材后,开发者可以根据本接口来删除不再需要的永久素材,节省空间。 请注意: 1、请谨慎操作本接口,因为它可以删除公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材(但需要先通过获取素材列表来获知素材的media_id) 2、临时素材无法通过本接口删除 3、调用该接口需https协议 接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/material/del_material?access_token=ACCESS_TOKEN 调用示例 { "media_id":MEDIA_ID } 参数说明 参数是否必须说明 access_token 是 调用接口凭证 media_id 是 要获取的素材的media_id 返回说明 { "errcode":ERRCODE, "errmsg":ERRMSG } 正常情况下调用成功时,errcode将为0。
  6. 修改永久图文素材 开发者可以通过本接口对永久图文素材进行修改。 请注意: 1、也可以在公众平台官网素材管理模块中保存的图文消息(永久图文素材) 2、调用该接口需https协议 接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/material/update_news?access_token=ACCESS_TOKEN 调用示例 { "media_id":MEDIA_ID, "index":INDEX, "articles": [{ "title": TITLE, "thumb_media_id": THUMB_MEDIA_ID, "author": AUTHOR, "digest": DIGEST, "show_cover_pic": SHOW_COVER_PIC(0 / 1), "content": CONTENT, "content_source_url": CONTENT_SOURCE_URL }, //若新增的是多图文素材,则此处应还有几段articles结构 ] } 参数说明 参数是否必须说明 media_id 是 要修改的图文消息的id index 是 要更新的文章在图文消息中的位置(多图文消息时,此字段才有意义),第一篇为0 title 是 标题 thumb_media_id 是 图文消息的封面图片素材id(必须是永久mediaID) author 是 作者 digest 是 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空 show_cover_pic 是 是否显示封面,0为false,即不显示,1为true,即显示 content 是 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS content_source_url 是 图文消息的原文地址,即点击“阅读原文”后的URL 返回说明 { "errcode": ERRCODE, "errmsg": ERRMSG } 正确时errcode的值应为0。
  7. 获取素材总数 开发者可以根据本接口来获取永久素材的列表,需要时也可保存到本地。 请注意: 1.永久素材的总数,也会计算公众平台官网素材管理中的素材 2.图片和图文消息素材(包括单图文和多图文)的总数上限为5000,其他素材的总数上限为1000 3.调用该接口需https协议 接口调用请求说明 http请求方式: GET https://api.weixin.qq.com/cgi-bin/material/get_materialcount?access_token=ACCESS_TOKEN 返回说明 { "voice_count":COUNT, "video_count":COUNT, "image_count":COUNT, "news_count":COUNT } 返回参数说明 参数描述 voice_count 语音总数量 video_count 视频总数量 image_count 图片总数量 news_count 图文总数量 错误情况下的返回JSON数据包示例如下(示例为无效媒体类型错误): {"errcode":-1,"errmsg":"system error"}
  8. 获取素材列表 在新增了永久素材后,开发者可以分类型获取永久素材的列表。(这里有 如何快速查找微信公众平台的历史图文消息素材 的小方法,是在公众平台上的,不是第三方网站的) 请注意: 1、获取永久素材的列表,也会包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材(但需要先通过获取素材列表来获知素材的media_id) 2、临时素材无法通过本接口获取 3、调用该接口需https协议 接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN 调用示例 { "type":TYPE, "offset":OFFSET, "count":COUNT } 参数说明 参数是否必须说明 type 是 素材的类型,图片(image)、视频(video)、语音 (voice)、图文(news) offset 是 从全部素材的该偏移位置开始返回,0表示从第一个素材 返回 count 是 返回素材的数量,取值在1到20之间 返回说明 永久图文消息素材列表的响应如下: { "total_count": TOTAL_COUNT, "item_count": ITEM_COUNT, "item": [{ "media_id": MEDIA_ID, "content": { "news_item": [{ "title": TITLE, "thumb_media_id": THUMB_MEDIA_ID, "show_cover_pic": SHOW_COVER_PIC(0 / 1), "author": AUTHOR, "digest": DIGEST, "content": CONTENT, "content_source_url": CONTETN_SOURCE_URL }, //多图文消息会在此处有多篇文章 ] }, "update_time": UPDATE_TIME }, //可能有多个图文消息item结构 ] } 其他类型(图片、语音、视频)的返回如下: { "total_count": TOTAL_COUNT, "item_count": ITEM_COUNT, "item": [{ "media_id": MEDIA_ID, "name": NAME, "update_time": UPDATE_TIME }, //可能会有多个素材 ] } 返回参数说明 参数描述 total_count 该类型的素材的总数 item_count 本次调用获取的素材的数量 title 图文消息的标题 thumb_media_id 图文消息的封面图片素材id(必须是永久mediaID) show_cover_pic 是否显示封面,0为false,即不显示,1为true,即显示 author 作者 digest 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空 content 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS content_source_url 图文消息的原文地址,即点击“阅读原文”后的URL update_time 这篇图文消息素材的最后更新时间 name 文件名称 错误情况下的返回JSON数据包示例如下(示例为无效媒体类型错误): {"errcode":40007,"errmsg":"invalid media_id"}

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏FreeBuf

Python勒索软件来袭,国产杀软集体失身

* 本文原创作者:降草,本文属FreeBuf原创奖励计划,未经许可禁止转载 近日,fortinet截获一种使用python语言编写的勒索软件,并将其命名为 ...

2259
来自专栏安恒信息

用户需警惕移动存储介质传播的木马新变种

通过对互联网监测发现,近期出现恶意木马程序变种Trojan_Generic.DP。该变种通过移动存储介质进行传播,使受感染操作系统无法正常进入安全...

3337
来自专栏七夜安全博客

练手之经典病毒熊猫烧香分析(上)

1593
来自专栏SAP最佳业务实践

SAP最佳业务实践:MM–组件收费的委外加工(251)-9抵扣的应付帐款

4.11 记录可抵扣的应付帐款 按照委外加工商的类型和冲销方法,基于与收费组件的委外加工商方面的金额,创建可抵扣的应付帐款。 (仅对SAP GUI,需要运行事务...

3956
来自专栏云资讯小编的专栏

腾讯安全反病毒实验室解读“Wannacry”勒索软件

MS17-010 漏洞指的是,攻击者利用该漏洞,向用户机器的 445 端口发送精心设计的网络数据包文,实现远程代码执行。如果用户电脑开启防火墙,也会阻止电脑接收...

5510
来自专栏FreeBuf

【推广】永恒之蓝WannaCry详细分析报

2017年5 月12 日晚上20 时左右,全球爆发大规模蠕虫勒索软件感染事件,仅仅几个小时内,该勒索软件已经攻击了99个国家近万台电脑。英国、美国、俄罗斯、德国...

2055
来自专栏张戈的专栏

Shell+Curl网站健康状态检查脚本,抓出中国博客联盟失联站点

一开始搭建中国博客联盟,既有博友提醒我,做网址大全这类网站维护很麻烦,需要大量的精力去 Debug 一些已夭折的网站,更是拿松哥的博客大全举例。当然,我也是深以...

3787
来自专栏ytkah

帝国CMS搜索页伪静态实现方法

  本文介绍帝国CMS搜索页url伪静态实现方法,可实现帝国CMS站内搜索结果页的伪静态显示,在使用帝国CMS二次开发中非常具有实用价值,需要的朋友可以参考下(...

3227
来自专栏漏斗社区

工具| 手把手教你制作信息收集器之网站备案号

本期任务: 1.掌握备案号的收集 。 2.练习从http返回包中获取信息的能力。 3.所需工具: pip,http请求库:requests库,匹配库:r...

45810
来自专栏landv

k3 Bos开发百问百答

1393

扫码关注云+社区