获取永久素材

在新增了永久素材后,开发者可以根据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,
    "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"}