详解nodejs微信公众号开发——5.素材管理接口
上一篇文章:,我们实现了被动回复文字和图文,回复图片失败,因为需要先获取通过素材管理接口上传多媒体文件而得到的mediaid,这一节们就来实现素材管理的接口。可参看:
1. 新增临时素材
临时素材顾名思义是临时的,上传后一定时间就被清理掉,适用于一些有时效性的图文链接。关于临时素材需要注意的点:
- 对于临时素材,每个素材(media_id)会在开发者上传或粉丝发送到微信服务器3天后自动删除(所以用户发送给开发者的素材,若开发者需要,应尽快下载到本地),以节省服务器资源。
- media_id是可复用的。
- 素材的格式大小等要求与公众平台官网一致。具体是,图片大小不超过2m,支持bmp/png/jpeg/jpg/gif格式,语音大小不超过5m,长度不超过60秒,支持mp3/wma/wav/amr格式
- 需使用https调用本接口。
请求地址:https://api.weixin.qq.com/cgi-bin/media/upload?access_token=access_token&type=type
1.1 实现uploadtempmaterial方法
uploadtempmaterial
是用来上传临时素材,直接在wechat的原型链上添加:
wechat.prototype.uploadtempmaterial = function(type,filepath){ var that = this; var form = { //构造表单 media:fs.createreadstream(filepath) } return new promise(function(resolve,reject){ that.fetchaccesstoken().then(function(data){ var url = api.uploadmaterial + 'access_token=' + data.access_token + '&type=' + type; request({url:url,method:'post',formdata:form,json:true}).then(function(response){ var _data = response.body; if(_data){ resolve(_data) }else{ throw new error('upload material failed!'); } }).catch(function(err){ reject(err); }); }); }); }
代码中的fetchaccesstoken
用以获取access_token
,修改回复数字2
的代码:
else if(content === '2'){ var data = yield wechatapi.uploadtempmaterial('image',__dirname+'/public/king.jpg'); reply = { type:'image', mediaid:data.media_id } }
先将本地的一张图片上传到临时素材接口,获取media_id,封装到回复消息里面去。同样的方法适用于语音,视频等:
2. 新增永久素材
永久素材回永远存储在微信后台服务器上,永不失效。关于永久素材有一下几个特点:
- 新增的永久素材也可以在公众平台官网素材管理模块中看到
- 永久素材的数量是有上限的,请谨慎新增。图文消息素材和图片素材的上限为5000,其他类型为1000
- 素材的格式大小等要求与公众平台官网一致。具体是,图片大小不超过2m,支持bmp/png/jpeg/jpg/gif格式,语音大小不超过5m,长度不超过60秒,支持mp3/wma/wav/amr格式
- 调用该接口需https协议
新增永久图文素材请求地址:https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=access_token
新增永久图片请求地址:https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=access_token
新增其他类型永久素材请求地址:https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=access_token
2.1 实现uploadpermmaterial方法
uploadpermmaterial
和uploadtempmaterial
方法基本是类似的,只是永久素材的的上传分为三类,需要判断一下传入的类型。
wechat.prototype.uploadpermmaterial = function(type,material){ var that = this; var form = {} var uploadurl = ''; if(type === 'pic') uploadurl = api.uploadpermpics; if(type === 'other') uploadurl = api.uploadpermother; if(type === 'news'){ uploadurl = api.uploadpermnews; form = material }else{ form.media = fs.createreadstream(material); } return new promise(function(resolve,reject){ that.fetchaccesstoken().then(function(data){ var url = uploadurl + 'access_token=' + data.access_token; var opts = { method:'post', url:url, json:true } (type == 'news') ? (opts.body = form) : (opts.formdata = form); //上传数据的方式不同 request(opts).then(function(response){ var _data = response.body; if(_data){ resolve(_data) }else{ throw new error('upload permanent material failed!'); } }).catch(function(err){ reject(err); }); }); }); }
注
:虽然实现了永久素材上传,但是测试账号也不是每一次都能测试成功,未经过认证的订阅号也不支持永久素材的上传。
3. 获取素材链接
由于获取临时素材和获取永久素材的差异性不大,直接放在一个函数里完成。
wechat.prototype.getmaterial = function(mediaid,permanent){ var that = this; var geturl = permanent ? api.getpermmaterial : api.gettempmaterial; return new promise(function(resolve,reject){ that.fetchaccesstoken().then(function(data){ var url = geturl + 'access_token=' + data.access_token; if(!permanent) url += '&media_id=' + mediaid; resolve(url) }); }); }
4. 删除永久素材
删除永久素材就比较简单了,只需传入一个mediaid
即可:
wechat.prototype.delmaterial = function(mediaid){ var that = this; return new promise(function(resolve,reject){ that.fetchaccesstoken().then(function(data){ var url = api.delpermmaterial + 'access_token=' + data.access_token; var form = {media_id:mediaid} request({url:url,method:'post',formdata:form,json:true}).then(function(response){ var _data = response.body; if(_data.errcode === '0'){ resolve(); }else{ throw new error('delete permanent material failed!'); } }).catch(function(err){ reject(err); }); }); }); }
5.其他
还有修改永久图文素材
、获取素材总数
、获取素材列表
功能由于本项目中不会用到,就不一一实现了。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。