详解nodejs微信公众号开发——5.素材管理接口

更新时间：2017年04月11日 17:03:13 作者：芒果屋里的猫

这篇文章主要介绍了详解nodejs微信公众号开发——5.素材管理接口，非常具有实用价值，需要的朋友可以参考下

上一篇文章：nodejs微信公众号开发——4.自动回复各种消息，我们实现了被动回复文字和图文，回复图片失败，因为需要先获取通过素材管理接口上传多媒体文件而得到的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.其他

还有修改永久图文素材、获取素材总数、获取素材列表功能由于本项目中不会用到，就不一一实现了。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

node内存泄漏排查与修复过程
之前开发了一个node接口,该接口使用canvas绘制产品图提供给java端使用,在运行了一段时间后发现了内存泄漏问题,本文浅记下修复过程,文章通过图文介绍的非常详细,需要的朋友可以参考下
2024-06-06
node.js连接mongoDB数据库快速搭建自己的web服务
这篇文章主要为大家详细介绍了node.js连接mongoDB数据库，如何快速搭建自己的web服务，感兴趣的小伙伴们可以参考一下
2016-04-04
Node.js中Swagger的使用指南详解
Swagger（目前用OpenAPI Specification代替）是一个用于设计、构建、记录和使用REST API的强大工具,本文将探讨使用Swagger的一些关键技巧,需要的可以参考一下
2024-01-01
node.js报错:npm ERR code EPERM的解决过程
在学习vue+typescript的时候突然发现了个错误,所以下面这篇文章主要给大家介绍了关于node.js报错:npm ERR code EPERM的详细解决过程,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
2022-08-08
node通过express搭建自己的服务器
本篇文章主要介绍了node通过express搭建自己的服务器，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-09-09
利用express启动一个server服务的方法
下面小编就为大家带来一篇利用express启动一个server服务的方法。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-09-09
深入浅出了解Node.js Streams
这篇文章讲了了解流的用途，为什么它们如此重要，以及如何使用它们。下面我们来一起学习吧
2019-05-05
NodeJS提供了的文件操作相关的API
让前端觉得如获神器的不是NodeJS能做网络编程,而是NodeJS能够操作文件,小至文件查找,大至代码编译,几乎没有一个前端工具不操作文件,换个角度讲,几乎也只需要一些数据处理逻辑,再加上一些文件操作,就能够编写出大多数前端工具
2023-11-11
NodeJS处理Express中异步错误
本文主要阐述如何在 Express 中使用错误处理中间件（error-handling middleware）来高效处理异步错误。在 Github 上有对应代码实例可供参考。
2017-03-03
Node.js中代码重复与不一致的问题及解决方案
在 Node.js 开发中,代码重复和不一致是常见的问题,尤其是在项目规模扩大和团队协作时,这些问题不仅会增加维护成本,还可能导致逻辑错误和性能问题,本文将探讨这些问题的常见原因,并提供相应的解决方案,需要的朋友可以参考下
2025-03-03

详解nodejs微信公众号开发——5.素材管理接口

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具