备案控制台
探索云世界
开发者社区 开发与运维 文章 正文

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

2015-03-20 1842
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 　　平时运营微信公众平台时有没发现素材管理有点不太好操作，特别是素材一多，找个东西都翻半天。现在好了，微信宣布公众平台新增素材管理接口，对所有认证公众号开放，方便快捷，可以实现同步互通。（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
目录
相关文章
老胡的储物柜
|
10月前
|
存储 监控 程序员
【教程&工具】微信同步文章到Bear
【教程&工具】微信同步文章到Bear
老胡的储物柜
148 0
CodeLeader
|
移动开发 前端开发 测试技术
微信公众号菜单管理接口开发
自定义菜单通过后台管理设置到数据库表，数据配置好后，通过微信接口推送菜单数据到微信平台。
CodeLeader
513 0
微信公众号菜单管理接口开发
卖坚果的怪叔叔
简单！三步实现微信消息同步！！
简单！三步实现微信消息同步！！
卖坚果的怪叔叔
144 0
简单！三步实现微信消息同步！！
技能实验室
微信公众号获取token，上传素材
微信公众号获取token，上传素材
技能实验室
133 0
奇了怪了怪
|
XML SpringCloudAlibaba 小程序
SpringCloud Alibaba 开发微信公众号 （模板消息管理）
SpringCloud Alibaba 开发微信公众号 （模板消息管理）
奇了怪了怪
211 0
码农工程师
微信图文内容自动同步到腾讯内容开放平台的操作步骤
微信图文内容自动同步到腾讯内容开放平台的操作步骤
码农工程师
178 0
微信图文内容自动同步到腾讯内容开放平台的操作步骤
技术君
微信图文内容自动同步到腾讯内容开放平台的操作步骤
微信图文内容自动同步到腾讯内容开放平台的操作步骤
技术君
96 0
微信图文内容自动同步到腾讯内容开放平台的操作步骤
程序员大阳
|
API
微信公众平台开发(16)--公众号二维码管理
本文目录 1. 概念 2. 代码 3. 测试 4. 小结
程序员大阳
275 0
程序员大阳
|
API
微信公众平台开发(14)--标签管理与用户标签管理
本文目录 1. 公众号标签的概念 2. 相关接口 3. 代码编写 4. 测试 4.1 获取标签 4.2 获取用户列表 4.3 为用户添加标签 4.4 查询标签 5. 小结
程序员大阳
466 0
i,am,jeff
|
前端开发 小程序
微信小程序 解决 wx.request同步问题 方便开发 Promise方式
微信小程序 解决 wx.request同步问题 方便开发 Promise方式
i,am,jeff
1094 0

热门文章

最新文章

  • 1
    微信小程序全栈开发之性能优化策略
  • 2
    基于SpringBoot+Vue+uniapp微信小程序的微信课堂助手小程序的详细设计和实现
  • 3
    微信小程序全栈开发中的身份认证与授权机制
  • 4
    基于SpringBoot+Vue+uniapp微信小程序的微信阅读网站小程序的详细设计和实现
  • 5
    微信小程序全栈开发中的PWA技术应用
  • 6
    深入解析微信小程序全栈开发流程
  • 7
    微信团队分享：来看看微信十年前的IM消息收发架构，你做到了吗
  • 8
    基于SpringBoot+Vue+uniapp微信小程序的电子商城购物平台的详细设计和实现
  • 9
    基于SpringBoot+Vue+uniapp微信小程序的教师管理系统的详细设计和实现
  • 10
    探索微信小程序全栈开发的安全性问题
  • 1
    Python爬虫-使用代理获取微信公众号文章
    62
  • 2
    微信公众号H5开发，在微信浏览器打开H5，无法一键下载图片
    47
  • 3
    Java网络爬虫实践：解析微信公众号页面的技巧
    31
  • 4
    微信公众平台开发基本配置
    89
  • 5
    自己动手做一个Server酱-cloudflare workers实现通过微信公众号发送消息
    100
  • 6
    C#微信公众号HIS预约挂号系统源码
    89
  • 7
    【微信公众号开发】基于golang的公众号开发——接入消息自动回复接口
    145
  • 8
    微信公众号后台回复5s重试解决方案和思路
    76
  • 9
    【微信公众号对接】有关签名一直报错，提示invalid signature问题（我的签名和使用微信开发者工具验证返回的签名的是一致的）但还是报错！！！
    52
  • 10
    【微信公众平台对接】有关【创建发票卡券模板】调用示例
    37

    • 相关课程

    更多
  • 网盘与相册服务产品介绍

    • 相关电子书

    更多
  • 微信广告引擎与播放节奏算法实践
  • 微信H5视频播放器在海量业务下的实践
  • 微信高效运维之路

    • 相关实验场景

    更多
  • 搭建微信小程序
  • 收银台的场景化界面实践
  • 星轨-钉钉APP分发实训
    • 下一篇
    部署LAMP环境（Alibaba Cloud Linux 3）