在新增了永久素材后,开发者可以根据media_id通过本接口下载永久素材。公众号在公众平台官网素材管理模块中新建的永久素材,可通过"获取素材列表"获知素材的media_id。

请注意:临时素材无法通过本接口获取

# 接口请求说明

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,
     "url":URL,
     "content_source_url":CONTENT_SOURCE_URL
     },
     //多图文消息有多篇文章
  ]
}

视频消息素材:

{
  "title":TITLE,
  "description":DESCRIPTION,
  "down_url":DOWN_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
url 图文页的URL
content_source_url 图文消息的原文地址,即点击“阅读原文”后的URL

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

{"errcode":40007,"errmsg":"invalid media_id"}