• UID13914
  • 登录2016-12-26
  • 粉丝0
  • 关注0
  • 发帖3
  • 主页
  • 金币22枚
IMWeb团队 发布于2016-11-23 20:43
0/142

图解微信公众号后台服务开发(nodejs版)

楼层直达


图解微信公众号后台服务开发(nodejs版)


标签:nodeJS全栈



本文作者:imweb 张颖 原文出处:imweb社区 未经同意,禁止转载

关于微信公众号开发的文章到处都是,基于nodejs的代码也不少,但是微信公众号给出的开发者文档接口虽然全却不细致,难免需要花费一些时间去测试确认,这里总结下最近基于nodejs的微信公众号后台服务开发的过程,采取的是简洁流程图的表达形式,希望能帮助没有接触过此类业务的小伙伴节约时间,快速上手。

1、如何获得一个微信公众号


首先要说明的是,微信公众号分服务号和订阅号两种,具体差别:
可以获得的接口权限,即可以提供的功能差异如下:
显然,服务号看上去功能更多,但是也需要根据业务场景考虑,要做到频繁给用户推送消息,还非订阅号不可。申请到公众号后,即可前往微信公众平台管理你的公众号。

2、简单的交互


如果你的微信公众号大致只需要以下功能:
  • 手动给用户推送图文消息
  • 利用底部菜单引导用户进入运营站点
  • 根据用户发送的关键字自动回复用户
  • 对用户发送的消息进行客服回复等

那只需要登录微信公众平台,在平台管理里面配置一些参数即可:
如果要一些自动化的功能,比如自动定期推送文章,绑定站点进行消息提醒,或者需要接入支付、卡劵、门店等高级接口功能,则需要自己开发公众号的后台服务。

3、启用服务器配置


如果启用了服务器配置后,可以在自己的服务器端进行代码开发处理微信消息,上一节介绍的在平台配置的自动回复、菜单等全部会失效。先来画一下启动服务器配置后,微信客户端、微信服务器如何与自己配置的服务器交互的。
很显然,首先应该去微信公众平台上配置自己的服务器信息,告诉微信服务器这个微信公众号的后台地址,以方便微信服务器进行消息转发。 当然,我们不可能随便填一个网址,而自己的服务器也不能随意接收没有校验的消息,所以这两者间绑定然后交互需要约定一个暗号,也就是Token值。第一次配置时,微信会像配置服务器发送带Token加密消息的校验信息,彼此确认身份,其后每次微信服务器和配置服务器交互信息时,也都会带上Token相关的身份校验信息。同样附上校验的流程图:
既然标题是基于nodejs的,我们还是贴一下nodejs中完成这些步骤的代码,相信有了流程图,开发同学们并不需要对代码有过多的解释,直接看代码就ok了。这里要介绍两个nodejs中开发微信公众号的模块,wechatwechat-api,这两个都是微信公众平台的基础库,封装了几乎所有微信开发者文档提供的接口。
使用express和wechat-api模块,app.use('/wechat', wechat('token', function (req, res, next) {})语句是用来验证token,其后的参数是验证通过后的回调执行函数,下面几节所贴的后台消息处理代码都位于此函数中:
var express = require('express'); var wechat = require('wechat'); var wechatCenter = require('./server/controllers/wechatCenter'); var config = require('./server/config'); // wechat development app.use('/wechat', wechat(config.wechat_validate.token, wechatCenter.all));

实际的校验算法如下:
 // 微信token认证底层实现 function sha1(str) { var md5sum = crypto.createHash("sha1");
     md5sum.update(str); str = md5sum.digest("hex");
     return str;
 } function validateToken(req, res) { var query = url.parse(req.url, true).query; // console.log("*** URL:" + req.url); // console.log(query); var signature = query.signature;
     var echostr = query.echostr;
     var timestamp = query['timestamp'];
     var nonce = query.nonce;
     var oriArray = new Array();
     oriArray[0] = nonce;
     oriArray[1] = timestamp;
     oriArray[2] = config.wechat_validate.token; //微信开发者中心页面里填的token oriArray.sort();
     var original = oriArray.join('');
     console.log("Original str : " + original);
     console.log("Signature : " + signature);
     var scyptoString = sha1(original); if (signature == scyptoString) {
         res.end(echostr);
         console.log("Confirm and send echo back");
     } else {
         res.end("false");
         console.log("Failed!");
     }
 }

以后每次有消息通过微信服务器转发过来,都会先做身份校验,校验后再将具体的消息交给回调函数进行处理。

4、定制图文推送业务


如果业务中需要应用到这样一种场景,目前有一个比较稳定的博客站点在运营,站点上每日都会有新文章发表,想通过微信公众号定期推送优秀文章。那我们来画一下实现此功能的流程和调用的接口:
可以看到,在图文消息上传前,文章内的图片都要从本地上传至微信服务器,然后获得微信服务器上的存放地址,文章的封面图同样需要本地上传,然后获得返回的唯一图片media_id,在图片都处理完毕后,可以正式的上传图文消息至微信服务器,上传后微信服务器会返回一个代表图文消息的唯一media_id,在需要群发时,只需调用群发接口,传递media_id参数即可。
// 上传图文消息内图片接口
api.uploadImage(options.filepath, function(err, result) {
        callback(err, result);
    });

// 上传多媒体文件接口,这里用来上传图文消息的封面图
api.uploadMedia(options.filepath, options.type, callback);

// 上传图文消息
api.uploadNews(options, callback);

// 图文消息预览
api.previewNews(options.openId, options.media_id, callback);

// 图文消息群发
api.massSendNews(options.media_id, true, callback);

具体接口参数格式,发送规则请查看wechatwechat-api,以及微信开发者文档

5、定制消息提醒业务


进一步,运营站点的文章有评论功能,如果想通过绑定微信账号在公众号内给用户发提醒要怎样实现呢?在用户与公众号没有交互的时候,公众号是不能任意的给用户发送消息的,此时就要用到微信提供的一种特殊消息推送接口——模板消息接口。微信公众平台开发者文档中解释:模板消息仅用于公众号向用户发送重要的服务通知,只能用于符合其要求的服务场景中。所以模板消息不是随意发的,发送内容也是受到限制的,微信平台上固定了很多模板消息类型供开发者选择,开发者可以利用公众号账号登陆开发者平台后,在账号内添加各类模板消息的模板,然后可以获得模板消息的唯一id标识template_id。然后在开发代码中,使用模板消息接口可以发送对应的提示消息。
function remindSend(options, callback) {
    // var templateId = 'UZG5ge7tdoZJrEi1kHiCkQ__ok27PX1HU_44Jji5iQ8'; var templateId = options.templateId || 'UZG5ge7tdoZJrEi1kHiCkQ__ok27PX1HU_44Jji5iQ8'; var topcolor = '#FF0000'; var url = options.topicLink; var data = options.data || { "first": { "value": "您好,您的文章" + options.title + "有新的评论", "color": "#173177" }, "keynote1": { "value": options.commentUser, "color": "#173177" }, "keynote2": { "value": options.create_at, "color": "#173177" }, "remark": { "value": "点击立刻查看评论。", "color": "#173177" }
    };

    api.sendTemplate(options.wechatId, templateId, url, topcolor, data, function(err, result) { if (!err) {
            callback && callback(result);
        } else {
            console.log(err);
        }
    });
}

微信用户收到的模板提醒消息如下:

6、网页授权获取用户信息业务


微信是允许某些站点页面唤起获取用户信息授权的流程,让用户确认是否同意当前页面获取用户的个人信息。那问题就来了,微信允许哪些页面呢?当然是公众号中绑定的域名下的页面,首先到公众平台官网中的开发者中心页配置授权回调域名,然后可以在微信中引导用户唤起用户信息授权流程,用户同意授权后,就可以在你配置的回调域名下的页面中获取到用户的个人信息。
说到具体的微信用户个人信息,那我们首先解释一下openid这个词,每个微信用户有唯一的微信号,然后每个用户对每个公众号有一个openid,对不同的公众号有不同的openid,但是用户对一个公众号而言openid是唯一的,用户与一个公众号之间通过openid通信,并且无论用户有没有关注某个公众号,它与公众号之间都是有一个唯一openid的。 解释完openid,我们再来具体描绘下整个引导用户授权的流程,以及如何获取到用户的具体信息。

总结


微信公众平台提供的接口功能还有许多,这里就不一一列举了,只要熟悉了开发流程和交互规则,功能实现起来都是类似的。




|||

0人打赏
您需要登录后才可以回帖
发表回复
极贡献
技术问答
专题荟萃
程序人生
视觉设计
Android开发
iOS开发
编程语言
前端开发
后端开发
服务器架构
软件测试
运维方案
创业路上



最热文章墙

  • 57718/339   【精品推荐】200多种Android动画效果的强悍框架,太全了,不看这个,再有动画的问题,不理你了^@^

  • 30985/139   省时省力的Android组件群来了,非常棒的原型参考

  • 30668/187   情人节福利,程序员表白的正确姿势:改几行代码就变成自己的表白了

  • 27378/216   【精品推荐】Android版产品级的音乐播放器源码,功能太强大了,最好的产品原型有木有?

  • 25738/2   超全!整理常用的iOS第三方资源

  • 23967/70   原创表白APP,以程序员的姿势备战新年后的7夕,持续完善中!

  • 22406/0   Python爬虫:常用浏览器的useragent

  • 21691/137   2016抢红包软件及源码

  • 19610/29   麻省理工的一帮疯子,真的实现了随意操控万物!(绝对黑科技)

  • 19451/25   Android工程师面试题大全

  • 18734/27   2016程序员跳槽全攻略

  • 18663/9   GitHub上排名前50的iOS项目:总有一款你用得着

  • 18197/20   码魂:程序员的牛B漫画

  • 16655/3   吐槽那些程序员的搞笑牛逼注释

  • 15746/146   Android版类似UC浏览器:非常赞,产品级的源码

  • 15470/1   iOS 动画总结

  • 14829/41   一个绚丽的loading动效分析与实现!

  • 14412/10   女程序员的梦,众网友的神回复

  • 14245/11   年会上现场review代码是怎么样的体验!

  • 14235/73   【持续更新中】Android福利贴(二):资料源码大放送

  • 14211/83   Android小而全的博客源码:非常适合全面掌握开发技巧

  • 14141/44   惊艳的App引导页:背景图片切换加各个页面动画效果

  • 13823/5   新一代Android渠道打包工具:1000个渠道包只需要5秒

  • 13663/10   2016年最全的Android面试考题+答案 精编版

  • 13657/23   个人收集的Android 各类功能源代码

  • 12927/19   珍藏多年的素材,灵感搜寻网站

  • 12814/53   基于瀑布流的美女图片浏览App,有注释的源代码

  • 12462/15   基于Android支付宝支付设计和开发方案

  • 12429/17   用JavaScript 来开发iOS和Android 原生应用:React Native开源框架中文版来啦

  • 12149/74   仿京东商城客户端Android最新版,不错的原型和学习资料

  • 12134/20   Android福利第三波【Android电子书】

  • 12078/17   什么是真正的黑客:收获12200+Stars,人气远超微软开源VS

  • 11613/18   65条最常用正则表达式,你要的都在这里了

  • 11533/94   Android带弹幕的视频播放器源码,来自大名鼎鼎的Bilibili弹幕网站

  • 11525/7   用程序员的姿势抢过年的火车票

  • 11495/70   【精品推荐】类似360安全卫士安Android源码:非常赞的产品原型

  • 11423/7   一张图搞定iOS学习路线,非常全面

  • 11311/11   有木有这样一张酷图帮你集齐所有git命令超实用

  • 11075/0   iOS中文版资源库,非常全

  • 10943/10   成为Java顶尖程序员 ,看这11本书就够了

  • 10535/18   一张图搞定Android学习路线,非常全面

  • 10507/10   微信支付终于成功了(安卓,iOS),在此分享

  • 10122/3   基于Node.js的强大爬虫,能直接发布抓取的文章哦

  • 10053/44   在线音乐播放器完整版(商用级的源码):非常赞,可听免费高品质专辑

  • 10050/29   【持续更新中】Android福利贴(一):资料源码

  • 10034/0   GitHub iOS 库和框架Top100 

  • 9697/4   46 个非常有用的 PHP 代码片段

  • 9334/3   即时通信第三方库

  • 9325/9   烧了5亿美金,这家神秘的公司即将颠覆人类未来!

  • 9187/8   流媒体视频直播方案

  • 9134/61   【技巧一】搭配Android Studio,如何实现App远程真机debug?

  • 9049/9   B站建开源工作组:APP想支持炫酷弹幕的看过来

  • 9000/2   【精品推荐】高质量PHP代码的50个实用技巧:非常值得收藏

  • 8909/9   中国黑客的隐秘江湖:攻守对立,顶尖高手月入千万美元

  • 8872/18   八个最优秀的Android Studio插件

  • 8441/6   开箱即用!Android四款系统架构工具

  • 8349/3   一张图看清Linux 内核运行原理

  • 8239/3   10款GitHub上最火爆的国产开源项目——可以媲美西半球

  • 8228/10   十大技巧快速提升Android应用开发性能

  • 7891/1   Android性能优化视频,文档以及工具

  • 返回顶部