AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

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

2015-03-20 1897
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 　　平时运营微信公众平台时有没发现素材管理有点不太好操作，特别是素材一多，找个东西都翻半天。现在好了，微信宣布公众平台新增素材管理接口，对所有认证公众号开放，方便快捷，可以实现同步互通。（4.29更新第三方平台也能为未微信认证的订阅号调用自定义菜单接口和素材管理接口） 　　微信公众平台素材管理接口具体如下： 新增临时素材 公众号经常有需要用到一些临时性的多媒体素材的场景，例如在使用接口特别是发送消息时，对多媒体文件、多媒体消息的获取和调用等操作，是通过media_id来进行的。

　　平时运营微信公众平台时有没发现素材管理有点不太好操作，特别是素材一多，找个东西都翻半天。现在好了，微信宣布公众平台新增素材管理接口，对所有认证公众号开放，方便快捷，可以实现同步互通。（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"}
文章标签：
API
开发者
数据格式
JSON
JavaScript
关键词：
微信同步
微信素材
微信公众平台素材
微信公众平台管理
第三方平台微信素材
ytkah8
目录
相关文章
六月的雨在钉钉
|
API
企业微信接入系列-上传临时素材
简述在API接口创建企业群发时上传临时素材的操作
六月的雨在钉钉
1838 0
企业微信接入系列-上传临时素材
mzlogin
|
2月前
|
Web App开发 前端开发 程序员
将微信公众号文章同步到阿里云开发者社区
本文介绍了一种通过自己拓展的浏览器插件，便捷地将微信公众号文章同步到阿里云开发者社区的方法。
mzlogin
52 6
向宇it
|
6月前
|
PHP
php使用curl新增微信临时素材(上传图片)
php使用curl新增微信临时素材(上传图片)
向宇it
285 4
朝阳39
|
5月前
|
前端开发 小程序 API
【微信小程序】使用 Promise、async 和 await 将异步API 改写为同步
【微信小程序】使用 Promise、async 和 await 将异步API 改写为同步
朝阳39
87 0
朝阳39
|
5月前
|
小程序 JavaScript 前端开发
【微信小程序-原生开发】实用教程06-轮播图、分类页签 tab 、成员列表（含Tdesign升级，切换调试基础库，设置全局样式，配置组件按需注入，添加图片素材，wx:for，生命周期 onLoad）
【微信小程序-原生开发】实用教程06-轮播图、分类页签 tab 、成员列表（含Tdesign升级，切换调试基础库，设置全局样式，配置组件按需注入，添加图片素材，wx:for，生命周期 onLoad）
朝阳39
172 0
好奇的菜鸟
|
6月前
|
Java
微信公众号素材下载之java
微信公众号素材下载之java
好奇的菜鸟
35 0
CodeLeader
|
移动开发 前端开发 测试技术
微信公众号菜单管理接口开发
自定义菜单通过后台管理设置到数据库表，数据配置好后，通过微信接口推送菜单数据到微信平台。
CodeLeader
771 0
微信公众号菜单管理接口开发
老胡的储物柜
|
存储 监控 程序员
【教程&工具】微信同步文章到Bear
【教程&工具】微信同步文章到Bear
老胡的储物柜
198 0
卖坚果的怪叔叔
简单！三步实现微信消息同步！！
简单！三步实现微信消息同步！！
卖坚果的怪叔叔
283 0
简单！三步实现微信消息同步！！
小牛呼噜噜
|
人工智能 小程序 数据安全/隐私保护
微信8.0状态视频无水印素材+个人设置技巧
微信8.0状态视频无水印素材+个人设置技巧
小牛呼噜噜
319 0
微信8.0状态视频无水印素材+个人设置技巧