> 微信公众号开发手册 > 获取素材列表

获取素材列表

获取素材列表

在新增了永久素材后,开发者可以分类型获取永久素材的列表。

请注意:

1、获取永久素材的列表,也包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材
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,
              "url": URL,
              "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,
      "url":URL
  },
  //可能会有多个素材
  ]
}

返回参数说明

参数 描述
total_count 该类型的素材的总数
item_count 本次调用获取的素材的数量
title 图文消息的标题
thumb_media_id 图文消息的封面图片素材id(必须是永久mediaID)
show_cover_pic 是否显示封面,0为false,即不显示,1为true,即显示
author 作者
digest 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空
content 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS
url 图文页的URL,或者,当获取的列表是图片素材列表时,该字段是图片的URL
content_source_url 图文消息的原文地址,即点击“阅读原文”后的URL
update_time 这篇图文消息素材的最后更新时间
name 文件名称

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

{"errcode":40007,"errmsg":"invalid media_id"}
上一篇: