获取永久素材


上一篇 : 新增永久素材 下一篇: 删除永久素材



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


上一篇 : 新增永久素材 下一篇: 删除永久素材