获取素材列表

来自企业号开发者接口文档
跳转至: 导航搜索

本接口可以获取当前管理组指定类型的素材列表。

  • 请求说明

Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/material/batchget?access_token=ACCESS_TOKEN

  • 请求包结构体为
{
   "type": "image", 
   "offset": 0, 
   "count": 10
}
  • 参数说明
参数 必须 说明
access_token 调用接口凭证
type 素材类型,可以为图文(mpnews)、图片(image)、音频(voice)、视频(video)、文件(file)
offset 从该类型素材的该偏移位置开始返回,0表示从第一个素材 返回
count 返回素材的数量,取值在1到50之间
  • 权限说明

所有管理组均可调用。

  • 返回说明

若为图片,文件,视频,音频则返回json格式如下

{
   "errcode": 0, 
   "errmsg": "ok",
   "type": "image", 
   "itemlist": [
       {
           "media_id": "2qN9QW-6HI3-AXuvAMi0vYQTyAm7k0Vgiuf7t5Kl4hjOwhYGwY", 
           "filename": "test01.png", 
           "update_time": 1434686658
       }
   ]
}

永久图文消息素材列表的返回如下

{

   "errcode": 0, 
   "errmsg": "ok", 
   "type": "mpnews",  
   "itemlist": [
       {
           "media_id": "2WETijvMxqfmtLwZMP6hpAvHsiYfhtIHIVU2a-n1nGH92Zizv4aHI8dSP8vZxYtt2", 
           "content": {
               "articles": [
                   {
                       "thumb_media_id": "20bTJJhtCbGebP9AtYa0eJ35cyU5CcyVobyx8iffQhapTBm5dSc3MbN6E15HaAG8u", 
                       "title": "test", 
                       "author": "fdasfas", 
                       "digest": "fdsafas", 
                       "content_source_url": "http://fasdf", 
                       "show_cover_pic": 1
                   }
               ]
           }, 
           "update_time": 1459844320
       }
   ]

}

参数 说明
type 素材类型,可以为图文(mpnews)、图片(image)、音频(voice)、视频(video)、文件(file)
itemlist 返回该类型素材列表
media_id 图文素材的媒体id
articles 图文消息,一个图文消息支持1到10个图文
title 图文消息的标题
thumb_media_id 图文消息缩略图的media_id, 可以在上传多媒体文件接口中获得。此处thumb_media_id即上传接口返回的media_id
author 图文消息的作者
content_source_url 图文消息点击“阅读原文”之后的页面链接
digest 图文消息的描述
show_cover_pic 是否显示封面,1为显示,0为不显示