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

  平时运营微信公众平台时有没发现素材管理有点不太好操作,特别是素材一多,找个东西都翻半天。现在好了,微信宣布公众平台新增素材管理接口,对所有认证公众号开放,方便快捷,可以实现同步互通。(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 条评论
登录 后参与评论

相关文章

来自专栏恰同学骚年

设计模式的征途—16.访问者(Visitor)模式

在患者就医时,医生会根据病情开具处方单,很多医院都会存在以下这个流程:划价人员拿到处方单之后根据药品名称和数量计算总价,而药房工作人员根据药品名称和数量准备药品...

492
来自专栏数据和云

表分区“拖出”的性能Error

作者介绍: 曾令军,云和恩墨技术专家,2009年开始接触ORACLE数据库,8年数据库运维经验。思维敏捷,擅长于数据库开发、解决棘手的数据库故障和性能问题。服务...

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

SAP最佳业务实践:使用看板的生产制造(233)-11重复制造反冲

1、MFBF重复制造反冲 此活动在单个步骤中执行多个活动,如产成品的收货、组件物料的反冲、成本到成本收集器的过帐以及物料和会计凭证的创建。 反冲时可能会出现错误...

3085
来自专栏更流畅、简洁的软件开发方式

【角色】——分离开代码和权限需求,即实现代码和权限需求的解耦。

今天突然来了一个灵感,记录一下。以前总觉得说不清楚,看看这种表达方式是否可以说清。 两个原则:依赖接口编程,不要依赖实现编程;最小获知原则。 面向对象最重要的是...

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

SAP最佳业务实践:MM–管道资源物料的采购(903)-2业务处理

3 流程概览表 步骤名称业务条件角色事务­代码预期结果过帐管道资源物料的发货发货已在系统中创建仓库管理员MIGO_GI根据计划协议过帐收货从管道资源提取收到发票...

3306
来自专栏salesforce零基础学习

salesforce 零基础开发入门学习(九)Approval Process 介绍

在阅读此篇文章前,可以先参考阅读一个前辈总结的关于Approval Process的操作。以下为参考的链接: http://www.cnblogs.com/mi...

1937
来自专栏牛客网

58到家java开发面经2018.5.18

1340
来自专栏互联网杂技

抛弃jQuery,拥抱原生JavaScript

Why not jQuery 1. 模式变革 jQuery 代表着传统的以 DOM 为中心的开发模式,但现在复杂页面开发流行的是以 React 为代表的以数据/...

3258
来自专栏数据小魔方

think-cell chart系列2——堆积百分比柱形图!

今天要跟大家分享的是think-cell chart系列的第二篇——堆积百分比柱形图! 我们还是先欣赏一下使用think-cell chart制作的堆积百分比柱...

3999
来自专栏深度学习计算机视觉

工厂方法模式

简单定义### 定义一个用于创建对象的接口,让子类决定实例化哪一个类,工厂方法使一个类的实例化延迟到其子类。 工厂方法(Factory Method)模式的意义...

3259

扫描关注云+社区