微信小店
微信门店
微信智能接口
微信设备功能

获取永久素材

出自微信公众平台开发者文档
跳转到: 导航, 搜索

在新增了永久素材后,开发者可以根据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,
     "thumb_url":THUMB_URL,
     "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)
thumb_url 图文消息的封面图片的地址,第三方开发者也可以使用这个URL下载图片到自己服务器中,然后显示在自己网站上
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"}