您的位置：首页 > 移动开发 > 微信开发

第三方平台可以通过微信公众平台素材管理接口实现同步了

2015-03-20 09:28 513 查看
　　平时运营微信公众平台时有没发现素材管理有点不太好操作，特别是素材一多，找个东西都翻半天。现在好了，微信宣布公众平台新增素材管理接口，对所有认证公众号开放，方便快捷，可以实现同步互通。（4.29更新第三方平台也能为未微信认证的订阅号调用自定义菜单接口和素材管理接口）

　　微信公众平台素材管理接口具体如下：

新增临时素材

公众号经常有需要用到一些临时性的多媒体素材的场景，例如在使用接口特别是发送消息时，对多媒体文件、多媒体消息的获取和调用等操作，是通过media_id来进行的。素材管理接口对所有认证的订阅号和服务号开放。
通过本接口，公众号可以新增临时素材（即上传临时多媒体文件）。但请注意，每个多媒体文件（media_id）会在开发者上传或粉丝发送到微信服务器3天后自动删除（所以用户发送给开发者的素材，若开发者需要，应尽快下载到本地），以节省服务器资源。请注意，media_id是可复用的。

本接口即为原“上传多媒体文件”接口。

接口调用请求说明

http请求方式: POST/FORM,需使用https
https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
调用示例（使用curl命令，用FORM表单方式上传一个多媒体文件）：
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

参数说明

参数是否必须说明
access_token是调用接口凭证
type是媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb）
media是form-data中媒体文件标识，有filename、filelength、content-type等信息
返回说明

正确情况下的返回JSON数据包结果如下：

{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}

参数描述
type媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb，主要用于视频与音乐格式的缩略图）
media_id媒体文件上传后，获取时的唯一标识
created_at媒体文件上传时间戳
错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：

{"errcode":40004,"errmsg":"invalid media type"}

注意事项

上传的临时多媒体文件有格式和大小限制，如下：

图片（image）: 1M，支持JPG格式

语音（voice）：2M，播放长度不超过60s，支持AMR\MP3格式

视频（video）：10MB，支持MP4格式

缩略图（thumb）：64KB，支持JPG格式

媒体文件在后台保存时间为3天，即3天后media_id失效。

获取临时素材

公众号可以使用本接口获取临时素材（即下载临时的多媒体文件）。请注意，视频文件不支持https下载，调用该接口需http协议。
本接口即为原“下载多媒体文件”接口。

接口调用请求说明

http请求方式: GET,https调用
https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
请求示例（示例为通过curl命令获取多媒体文件）
curl -I -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

参数说明

参数是否必须说明
access_token是调用接口凭证
media_id是媒体文件ID
返回说明

正确情况下的返回HTTP头如下：

HTTP/1.1 200 OK
Connection: close
Content-Type: image/jpeg
Content-disposition: attachment; filename="MEDIA_ID.jpg"
Date: Sun, 06 Jan 2013 10:20:18 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 339721
curl -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

错误情况下的返回JSON数据包示例如下（示例为无效媒体ID错误）：:

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


新增永久素材

除了3天就会失效的临时素材外，开发者有时需要永久保存一些素材，届时就可以通过本接口新增永久素材。
请注意：

1、新增的永久素材也可以在公众平台官网素材管理模块中看到
2、永久素材的数量是有上限的，请谨慎新增。图文消息素材和图片素材的上限为5000，其他类型为1000
3、调用该接口需https协议

新增永久图文素材

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN

调用示例

{
"articles": [{
"title": TITLE,
"thumb_media_id": THUMB_MEDIA_ID,
"author": AUTHOR,
"digest": DIGEST,
"show_cover_pic": SHOW_COVER_PIC(0 / 1),
"content": CONTENT,
"content_source_url": CONTENT_SOURCE_URL
},
//若新增的是多图文素材，则此处应还有几段articles结构
]
}

参数说明

参数是否必须说明
title是标题
thumb_media_id是图文消息的封面图片素材id（必须是永久mediaID）
author是作者
digest是图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空
show_cover_pic是是否显示封面，0为false，即不显示，1为true，即显示
content是图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS
content_source_url是图文消息的原文地址，即点击“阅读原文”后的URL
返回说明

{
"media_id":MEDIA_ID
}

返回的即为新增的图文消息素材的media_id。

新增其他类型永久素材

接口调用请求说明

通过POST表单来调用接口，表单id为media，包含需要上传的素材内容，有filename、filelength、content-type等信息。请注意：图片素材将进入公众平台官网素材管理模块中的默认分组。

http请求方式: POST
http://file.api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN
调用示例（使用curl命令，用FORM表单方式新增一个其他类型的永久素材）：
curl -F media=@test.jpg "http://file.api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN"

参数说明

参数是否必须说明
access_token是调用接口凭证
type是媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb）
media是form-data中媒体文件标识，有filename、filelength、content-type等信息
新增永久视频素材需特别注意

在上传视频素材时需要POST另一个表单，id为description，包含素材的描述信息，内容格式为JSON，格式如下：

{
"title":VIDEO_TITLE,
"introduction":INTRODUCTION
}

新增永久视频素材的调用示例：

curl "http://file.api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN" -F media=@media.file -F  description='{"title":VIDEO_TITLE, "introduction":INTRODUCTION}'

参数说明

参数是否必须说明
title是视频素材的标题
introduction是视频素材的描述
返回说明

{
"media_id":MEDIA_ID
}

返回参数说明

参数描述
media_id新增的永久素材的media_id
错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：

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


获取永久素材

在新增了永久素材后，开发者可以根据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,
"content_source_url":CONTENT_SOURCE_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
content_source_url图文消息的原文地址，即点击“阅读原文”后的URL
错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：

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


删除永久素材

在新增了永久素材后，开发者可以根据本接口来删除不再需要的永久素材，节省空间。
请注意：

1、请谨慎操作本接口，因为它可以删除公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材（但需要先通过获取素材列表来获知素材的media_id）
2、临时素材无法通过本接口删除
3、调用该接口需https协议

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/material/del_material?access_token=ACCESS_TOKEN

调用示例

{
"media_id":MEDIA_ID
}

参数说明

参数是否必须说明
access_token是调用接口凭证
media_id是要获取的素材的media_id
返回说明

{
"errcode":ERRCODE,
"errmsg":ERRMSG
}

正常情况下调用成功时，errcode将为0。

修改永久图文素材

开发者可以通过本接口对永久图文素材进行修改。
请注意：

1、也可以在公众平台官网素材管理模块中保存的图文消息（永久图文素材）
2、调用该接口需https协议

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/material/update_news?access_token=ACCESS_TOKEN

调用示例

{
"media_id":MEDIA_ID,
"index":INDEX,
"articles": [{
"title": TITLE,
"thumb_media_id": THUMB_MEDIA_ID,
"author": AUTHOR,
"digest": DIGEST,
"show_cover_pic": SHOW_COVER_PIC(0 / 1),
"content": CONTENT,
"content_source_url": CONTENT_SOURCE_URL
},
//若新增的是多图文素材，则此处应还有几段articles结构
]
}

参数说明

参数是否必须说明
media_id是要修改的图文消息的id
index是要更新的文章在图文消息中的位置（多图文消息时，此字段才有意义），第一篇为0
title是标题
thumb_media_id是图文消息的封面图片素材id（必须是永久mediaID）
author是作者
digest是图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空
show_cover_pic是是否显示封面，0为false，即不显示，1为true，即显示
content是图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS
content_source_url是图文消息的原文地址，即点击“阅读原文”后的URL
返回说明

{
"errcode": ERRCODE,
"errmsg": ERRMSG
}

正确时errcode的值应为0。

获取素材总数

开发者可以根据本接口来获取永久素材的列表，需要时也可保存到本地。
请注意：

1.永久素材的总数，也会计算公众平台官网素材管理中的素材
2.图片和图文消息素材（包括单图文和多图文）的总数上限为5000，其他素材的总数上限为1000
3.调用该接口需https协议

接口调用请求说明

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/material/get_materialcount?access_token=ACCESS_TOKEN

返回说明

{
"voice_count":COUNT,
"video_count":COUNT,
"image_count":COUNT,
"news_count":COUNT
}

返回参数说明

参数描述
voice_count语音总数量
video_count视频总数量
image_count图片总数量
news_count图文总数量
错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：

{"errcode":-1,"errmsg":"system error"}


获取素材列表

在新增了永久素材后，开发者可以分类型获取永久素材的列表。（这里有 如何快速查找微信公众平台的历史图文消息素材 的小方法，是在公众平台上的，不是第三方网站的）
请注意：

1、获取永久素材的列表，也会包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材（但需要先通过获取素材列表来获知素材的media_id）
2、临时素材无法通过本接口获取
3、调用该接口需https协议

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN

调用示例

{
"type":TYPE,
"offset":OFFSET,
"count":COUNT
}

参数说明

参数是否必须说明
type是素材的类型，图片（image）、视频（video）、语音 （voice）、图文（news）
offset是从全部素材的该偏移位置开始返回，0表示从第一个素材 返回
count是返回素材的数量，取值在1到20之间
返回说明

永久图文消息素材列表的响应如下：

{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"media_id": MEDIA_ID,
"content": {
"news_item": [{
"title": TITLE,
"thumb_media_id": THUMB_MEDIA_ID,
"show_cover_pic": SHOW_COVER_PIC(0 / 1),
"author": AUTHOR,
"digest": DIGEST,
"content": CONTENT,
"content_source_url": CONTETN_SOURCE_URL
},
//多图文消息会在此处有多篇文章
]
},
"update_time": UPDATE_TIME
},
//可能有多个图文消息item结构
]
}

其他类型（图片、语音、视频）的返回如下：

{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"media_id": MEDIA_ID,
"name": NAME,
"update_time": UPDATE_TIME
},
//可能会有多个素材
]
}

返回参数说明

参数描述
total_count该类型的素材的总数
item_count本次调用获取的素材的数量
title图文消息的标题
thumb_media_id图文消息的封面图片素材id（必须是永久mediaID）
show_cover_pic是否显示封面，0为false，即不显示，1为true，即显示
author作者
digest图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空
content图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS
content_source_url图文消息的原文地址，即点击“阅读原文”后的URL
update_time这篇图文消息素材的最后更新时间
name文件名称
错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：

{"errcode":40007,"errmsg":"invalid media_id"}
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息
标签： 
相关文章推荐
新的分享
章节导航