微信公众平台新增素材管理接口,方便快捷实现同步互通

2024-09-17
来源:网络整理

在操作微信公众平台的时候,大家有没有发现素材管理有点难操作,特别是素材很多的时候,找东西要花很长时间。现在好了,微信宣布公众平台新增素材管理接口,面向所有认证公众号开放,方便快捷,还能实现同步互通。(4.29更新,非微信认证的订阅号第三方平台也可调用自定义菜单接口和素材管理接口)

微信公众平台素材管理界面如下:

添加临时素材 公众号经常需要用到一些临时的多媒体素材,比如在使用接口的时候,特别是发送消息的时候,获取、调用多媒体文件、多媒体消息等操作都是通过素材管理接口进行的。素材管理接口对所有认证订阅号和服务号开放,通过此接口,公众号可以添加临时素材(也就是上传临时的多媒体文件)。但请注意,每个多媒体文件()在开发者上传或者粉丝发送到微信服务器3天后就会被自动删除(所以用户发给开发者的素材,开发者如果需要的话要尽快下载到本地电脑),以节省服务器资源,请注意是可以重复使用的。此接口就是原来的“上传多媒体文件”接口。接口调用请求说明http请求方式:POST/FORM,调用示例(使用curl命令以FORM形式上传多媒体文件):curl -F =@test.jpg "" 参数说明该参数是否必须描述是调用接口的凭证type是媒体文件类型,包括()、()、()和()是form-data中的媒体文件标识,包括,,-type等信息返回说明正确情况下返回的JSON数据包结果如下:{"type":"TYPE","":"","":} 参数说明type媒体文件类型,包括()、()、()和(),主要用于视频、音乐格式的缩略图媒体文件上传后,获取时的唯一标识媒体文件上传时间戳有错误情况下返回的JSON数据包示例如下(示例为无效的媒体类型错误):{"":,"":"type"} 注意上传的临时多媒体文件有格式和大小限制,具体如下:

媒体文件在后台保存3天,3天后失效。

获取临时素材公众号可以通过此接口获取临时素材(即下载临时的多媒体文件),请注意视频文件不支持下载,调用此接口需要http协议,此接口即原有的“下载多媒体文件”接口。 接口调用请求说明 http请求方式:GET,调用请求示例(示例是通过curl命令获取多媒体文件) curl -I -G "" 参数说明 必须指定的参数 是调用接口凭证 是媒体文件ID 返回说明 正确情况下返回的HTTP头如下: HTTP/1.1 200 OK : -Type: /jpeg -: ; =".jpg" Date: Sun, 06 Jan 2013 10:20:18 GMT -:no-,must- -:curl -G "" 错误情况下返回的JSON数据包如下(示例为无效的媒体ID错误): : {"":,"":" "} 添加永久素材 除了3天后过期的临时素材外,开发者有时需要永久​​保存一些素材,这时候就可以通过此接口添加永久素材。

请注意:1、新增永久素材在公众平台官网素材管理模块也能看到。2、永久素材数量有限,请谨慎添加,图文素材、图片素材上限为5000条,其他类型上限为1000条。3、调用该接口需要协议添加永久图文素材接口调用请求说明http请求方式:POST调用示例{"":[{"":,"":,"":,"":,"":,"":,"":(0 / 1),"":,"":},如果新增图文素材为多条,这里要多加几个结构体]}参数说明参数必填说明是为图文封面图片素材id(必须是永久的)是为图文摘要,只有单条图文才有摘要。对于多图文,此为空 是 是否显示封面,0为是,即不显示,1为是,即显示图文消息具体内容,支持HTML标签,必须小于2万字符且小于1M,并且会去除JS 这里 是图文消息原始地址,即点击“阅读原文”后的URL 返回说明 { "": } 返回的是新增加的图文消息素材。

微信公众平台第三方方_三方公众微信平台官网_三方公众微信平台是什么

添加了其他类型永久素材接口调用请求说明 通过POST表单调用接口,表单id为,里面包含了需要上传的素材内容,包含,,-type等信息。请注意:图片素材会进入公众平台官网素材管理模块中的默认分组。:http请求方式:POST 调用示例(使用curl命令以FORM表单添加其他类型的永久素材):curl -F =@test.jpg "" 参数说明 参数是否必须指定 是调用接口凭证 type 是媒体文件类型,包含图片()、语音()、视频()和缩略图() 是表单中的媒体文件标识-data,包含,,-type等信息。添加永久视频素材特别注意,上传视频素材时,需要POST另一个带id的表单,里面包含了素材的描述信息。内容格式为JSON,格式如下: { "":, "": } 添加永久视频素材的调用示例: curl "" -F =@.file -F ='{"":, "":}' 参数说明 是否必须指定参数 是视频素材的标题 是视频素材的描述 返回说明 { "": } 返回参数说明 参数说明 添加永久素材错误情况下返回JSON数据包示例如下(示例为无效的媒体类型错误): {"":,"":" "} 获取永久素材 添加永久素材后,开发者可根据 获取永久素材,并在需要时保存到本地。

请注意: 1、获取永久素材,还可以在公众平台官网素材管理模块中获取公众号新创建的图文、语音、视频等素材(但需要先获取素材列表才能知道素材) 2、无法通过此接口获取临时素材 3、调用此接口需要协议接口调用请求说明http请求方法:POST,调用调用示例 { "": } 参数说明参数必须指定是调用接口凭证即为要获取的素材返回说明若请求的素材为图文,则响应如下: { "": [{"":,""::,"":(0/1),"":,"":,"":,"":},//多条图文有多篇文章] } 对于其他类型的素材消息,响应直接就是素材内容,开发者可以自行保存为文件。

例如: 示例 curl "" -d '{"":""}' > file 返回参数说明 参数说明 图文消息标题 图文消息封面图片素材id(必须是永久的) 是否显示封面,0为真,即不显示,1为真,即显示作者图文消息摘要。单图文消息才有摘要,多图文这里为空。 图文消息具体内容支持HTML标签,必须小于2万字符且小于1M,这里会去除JS。 图文消息原始地址,即点击“阅读原文”后的URL 错误情况下返回的JSON数据包示例如下(示例为无效的媒体类型错误): {"":,"":" "} 删除永久素材 添加永久素材后,开发者可以通过此接口删除不再需要的永久素材,以节省空间。

请注意: 1.请谨慎操作此接口,因为它可以删除公众平台官网素材管理模块中公众号新创建的图文消息,语音,视频等素材(但需要先获取素材列表才能知道素材) 2.无法通过此接口删除临时素材 3.调用此接口需要协议 接口调用说明 http请求方式:POST 调用示例 { "": } 参数说明 必须指定参数 是调用接口凭证 是要获取的素材 返回说明 {"":,"": } 正常情况下调用成功会为0。 修改永久图文素材 开发者可以通过此接口修改永久图文素材。 请注意: 1.您还可以在公众平台官网素材管理模块中保存图文消息(永久图文素材)。 2.调用该接口需要协议接口调用请求说明http请求方式:POST调用示例{"":, "":, "":[{"": ,"": ,"": ,"": ,"": ,"": (0 / 1),"": ,"": },//如果新增了多个图文素材,这里要多加几个结构体]}参数说明是否必须指定参数是需要修改的图文信息的id是需要更新的文章在图文信息中的位置(有多条图文信息时该字段才有意义),第一篇文章是0是标题是图文信息的封面图片素材id(必须永久存在)是作者是图文信息摘要,只有单条图文信息才有摘要。对于多图文,这个为空是否显示封面,0为真,即不显示,1为真,即显示图文消息具体内容,支持HTML标签,必须小于2万字符且小于1M,这里会去除JS 为图文消息原始地址,即点击“阅读原文”后的URL 返回描述 { "": , "": } 正确值应该是0。

获取素材总数 开发者可以通过此接口获取永久素材列表,需要时可以保存到本地。 请注意: 1.永久素材总数也包含公众平台官网素材管理中的素材 2.图片及图文消息素材(包括单图及多图)总数上限为5000个,其他素材总数上限为1000个 3.调用此接口需要协议 接口调用 请求说明 http请求方法:GET 返回说明 { "":, "":, "":, "": } 返回参数说明 参数说明 声音总数 视频总数 图片总数 图文总数 以下是出错情况下返回的JSON数据包示例(示例为无效媒体类型错误): {"":-1,"":" "} 获取素材列表 添加永久素材后,开发者可以按类型获取永久素材列表。 (这里介绍一下如何快速找到微信公众平台历史图文素材的小技巧,是在公众平台,而不是第三方网站。)请注意:1、获取永久素材列表时,还会包含公众平台官网素材管理模块中公众账号新创建的图文、语音、视频等素材(但需要先获取素材列表才能知道素材)。2、临时素材无法通过此接口获取。 3.调用该接口需要协议接口调用请求说明http请求方式:POST调用示例{"type":TYPE,"":,"":}参数说明是否必须指定参数type为素材类型,图片()、视频()、语音()、图文(新闻)返回从这个偏移位置开始的所有素材,0表示从第一个素材开始返回是返回素材个数,值在1-20之间。返回说明响应永久图文消息素材列表如下:{"":, "":, "item":[{"":, "":{"":[{"":, "":, "": (0 / 1),"":, "":, "":, "":},//多条图文消息这里就会有多篇文章]},"":},//图文消息item结构可能会有多个]}其他类型(图片、音频、视频)的返回如下:{"":, "":, "item":[{"":, "name": NAME,"": },//可能有多个素材] } 返回参数说明 参数说明 该类型素材总数 本次调用获取到的素材数量 图文消息标题 图文消息的封面图片素材id(必须是永久的) 是否显示封面,0表示不显示,1为是,即显示作者图文摘要,只有单张图文消息才有摘要,对于多张图文,此项为空 图文消息的具体内容,支持HTML标签,必须小于2万字符且小于1M,此处会去除JS 图文消息原始地址,即点击“阅读原文”后的URL 本图文消息素材名称最后更新时间 文件名不正确的情况下返回的JSON数据包示例如下(示例为无效的媒体类型错误): {"":,"":" "}

本文参与腾讯云自媒体同步曝光计划,分享自作者个人站/博客。

分享