阅读(1219) (0)

获取微信公众平台的素材列表

2016-10-10 09:10:37 更新

获取素材列表

微信素材

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

请注意:

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"}