微信公众号开发笔记1(nodejs开发的)

Posted 2020-09-16 __记忆

本篇记录了微信公众号开发的一些笔记

一、微信服务器与我们服务器的交流

微信开发者拥有自己的服务器，在我们服务器上可以与微信服务器进行交流。既然可以交流，那就必定需要前提条件（微信认证），也就是说，只有自己的服务器与微信服务器进行认证通过后，才能与他交流。如何进行认证？

1. 接口认证

接口的认证是token验证，微信服务器会发送一个get请求给我们在公众号配置的接口，如http://xxxx/weixin/api ，这个请求带了如下参数

然后，微信规定我们

1）将token、timestamp、nonce三个参数进行字典序排序 （token是在微信后台配置的）

2）将三个参数字符串拼接成一个字符串进行sha1加密

3）开发者获得加密后的字符串可与signature对比，标识该请求来源于微信

通过上述三步，如果加密后的字符串与signature是相同的，那么认证成功，我们就给微信返回 echostr 接口结束。

nodejs代码如下：

app.get(\'/weixin/api\', function (req, res) {
        var query = req.query
        var signature   = query.signature
        var nonce       = query.nonce
        var timestamp   = query.timestamp
        var echostr     = query.echostr
        // token在配置文件里
        var str = [weixinConfig.token, timestamp, nonce].sort().join(\'\')
        // 利用sha1模块进行sha1加密
        var sha = sha1(str)

        if (sha === signature) {
            res.send(echostr)
        } else {
            res.send(\'wrong wrong wrong\')
        }
    })

这样，我们就完成了微信接口认证。我们可以与微信进行交流了。

2. 接收微信推送内容

每一个微信动态（如：我们推送一篇图文给某个用户，或者用户点击了某个菜单），微信服务器都会给我们推送事件消息。微信服务器会以post请求的方式以xml格式推送给我们数据。因此，微信认证的路由我们还需要定义post接口来接收来自微信的推送消息。

2.1.情景模拟

1. 某一个时间，我们需要给某用户发送一个图文消息，发送成功后，微信服务器收到发送成功的响应，则微信服务器就会将这个动作的响应发给我们服务端，告诉我们结果，然后我们做出相应的行为。

2. 用户点击了某个图文菜单，微信服务器接收到请求，则微信服务器将这个请求消息发送给我们服务端，让我们做出进一步相应的行为（返回给用户图文）。

这两种情况微信都是以xml格式发送给我们数据的。我们需要接收。每一个微信服务器发送的post请求，我们都必须做相应的回复，比如用户点击图文菜单，我们要给用户发送一个图文，我们只需要以微信规定的的xml格式send给微信服务器的这个请求就可以了。

2.2 微信推送消息的类型（xml格式中的Event内容）

1. click：事件类型，又分自定义事件和微信端事件。

2. text：文本类型。

下面是nodejs的接口代码，用了xml2js的xml解析模块。weixinAutoMessage是个对象，下面包含了所有动作的接口。

app.post(\'/weixin/api\', function (req, res) {
      //获取xml数据
            req.on("data", function(data) {
                //将xml解析
                console.log(\'收到微信消息的xml：\' + data)
                parser.parseString(data.toString(), function(err, result) {
                    var body = result.xml;
                    var messageType = body.MsgType[0];

                    if(messageType === \'event\') {

                        // 如果是自定义事件，那么就取事件名为body.EventKey的第一个参数
                        var eventName = body.Event[0] === \'CLICK\' ? body.EventKey[0]: body.Event[0];
                        console.log(\'事件类型是：\' + eventName);
                        weixinAutoMessage[eventName](body, res)
                    }else if(messageType === \'text\') {
                        weixinAutoMessage.responseMessage(body, res);
                    }
                });
            });
})

二、access_token的获取

对于一个话都说不清楚的我，感觉上面写的自己都看不懂。语言组织能力太差了。不过这个access_token应该好懂的。

access_token介绍：这个东西是一个调用微信api时认证用的，每一个微信api都需要加上这个东西。下面称atoken。

微信规定，开发者需要从微信服务器上获取一个叫atoken的字串，并保存到自己的数据库中，微信端的atoken会每2小时更新一次，也就是说，我们服务器需要获取一次atoken后的2小时候再次获取一次atoken，保证我们存储的atoken与微信端保持一致，因为我们调用微信接口需要atoken认证。

这个atoken获取很简单了，看文档

我们调用这个微信接口就可以了，我们需要传递的就是appid secret，这两个都是在微信公众号后台的参数。我们调用这个接口，微信就返回一个最新的atoken，这里说一下2小时的计算是在你获取atoken后开始计算的。

如果你在9点获取了atoken， 微信就开始计算2小时后失效，也就是11点失效。

如果你在10点又获取了一次atoken，微信就重新计算2小时，也就是12点后失效。

因此根据特性，我们在一次获取atoken后，在2小时内重新获取即可。

getAccessToken () {
  var url = \'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential\' +
    \'&appid=\' + weixinConfig.appId +
    \'&secret=\' + weixinConfig.appSecret
// request模块发送请求
request({
    uri: url,
    method: \'GET\',
    timeout: 10000,
    followRedirect: true,
    maxRedirects: 10,
    json: true
}, function (err, res,body) {
   // ... 进行存储操作
  })
}

定时获取便是开启一个定时器了

//  一小时获取一次
setInterval(getAccessToken, 60 * 60 * 1000)

总结

access_token 我这样1小时获取一次，并且保证了重启服务器后开启新定时器不会超过两小时，为啥我在使用access_token是经常是已经过期！这个问题搞了很久都不知道原因，后来，在每一次使用access_token时都进行一个试探性验证，如果此时access_token失效了，重新获取后再做下一步操作。这是我的方法。但是为什么2小时内access_token失效并不知道。。尴尬。。。。。。

由于并没有专注研究微信公众号开发，可能一些地方是错的，然而我并没有发现。有大佬看到了请指正。

另外附上最新自己搞的网站，还在开发中，不要脸的附上。有看到的同学可以进来看看啊，支持一下:   记忆课堂