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

Posted 2020-09-17 __记忆

本篇主要记录调用微信各种api和功能实现

一、始于access_token

无论调用微信的什么api，都需要一个查询参数，就是我们每隔1小时或者2小时获取的access_token，笔记1中已经保证了本地存储的access_token与微信服务器端一致，此时，我们就可以使用我们本地的atoken成功调用api了。

我的思路是，写一个函数getAccessToken，该函数接收一个函数参数，也就是回调函数。我们在getAccessToken中获取到我们本地的atoken后执行我们的回调函数逻辑，以参数形式，把atoken传递给回调函数，供回调函数使用。很简单的逻辑，就是一个回调函数的使用。

getAccessToken如下：

function getAccessToken(callback) {

    Weixin.findOne(filter, function(err, data) {
        //  查询到accessToken后，执行回调函数
        callback(data.accessToken)
    })
}

简单写一下逻辑，不会贴源代码的。getAccessToken函数就如上所示，很简单的道理。

调用api时如下：

自定义菜单为例

getAccessToken(function(accessToken) {
//   菜单的json配置项，下面会介绍
    var menusData = config.weixinMenu

    request({
        method: \'POST\',
        url: "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=" + accessToken,
        json: true,
        body: menusData
    }, function(err, res, body) {
        //  请求完成， body中保存着请求结果，可进一步操作
    })


})

就如上所示，我们在创建菜单时，先获取accessToken，利用回调的特性，拿到accessToken来进行微信api调用。

遗留的问题

我在开发时老是遇到accessToken失效导致了api调用失败，笔记1中提到过，我也没搞清楚失效的原因，不明觉厉啊，如果你也遇到了这个问题，就看一下我的解决办法，如下：getAccessToken获取后，首先不会执行回调，而是利用accessToken发起一个微信api请求，查看返回的body结果，如果errcode是0，也就是accessToken是最新的，就执行回调。如果不是，本地的accessToken过期了，那么重新从微信服务器获取accessToken再执行回调。

代码如下：

function getAccessToken(callback) {

    Weixin.findOne(filter, function(err, data) {
        //  查询到accessToken后，发起一个验证请求

        request({
            url: "https://api.weixin.qq.com/cgi-bin/getcallbackip?access_token=" + data.accessToken,
            method: \'GET\'
        }, function(err, res, body) {
            //  如果errcode是 0 ，则accessToken有效，执行回调，如果不是，就获取新的atoken后执行回调
            if (!body.errcode) {
                callback(data.accessToken)
            } else {
                getNewAccessToken(callback)
            }
        })

    })
}

感觉回调的优点深，代码有点差。就这么个逻辑了。获取新的accessToken函数就和从前一样。 上面这个api是获取微信服务器ip地址的，用来测试accessToken好了。

二、最基础的菜单生成

看文档，这是规定

菜单的类型，最常用的就是click和view：

博主在这里煞费苦心，看半天也不懂。主要是，在做自定义菜单时，还没搞懂笔记1中的微信接口接入和服务器间的交互。现在懂了，菜单是这样生成的。

1、view类型的菜单

一般用来访问我们的h5页面。用户点击菜单进入我们的h5页面，一般我们需要静默授权或者用户授权来获取用户的一些信息。从而与用户交互。

授权也很简单，在这里先不说，文档说的也很详细了。

2.click类型菜单

 很多菜单时点击推送一篇图文或者其他视频或者其他消息，这个怎么做呢，就用到了click类型的菜单配置。

click类型类似于给此菜单按钮加了点击事件，用户点击这个菜单，微信服务器会发送信息给我们服务器，告诉我们用户点击了菜单，click事件的key值（我们自己配的），也就是说我们配置的所有click类型菜单，都会配置一个key值，用户点击对应菜单，会推送消息给我们服务器，根据这个key值来进行主观的操作，返回一篇图文给用户啊，或者返回一个连接给用户啊，或者怎么着。

一个菜单配置项的示例

var menusConfig = {
    "button": [{
        name: "某某论坛",
        type: "view",
        url: homeUrl
    }, {
        name: "本站介绍",
        type: \'click\',
        key: "intro"
    }, {
        name: "图文列表",
        "sub_button": [{
            name: "图文1",
            type: "click",
            key: "new1"
        }, {
            name: "图文2",
            type: "click",
            key: "new2"
        }, {
            name: "图文3",
            type: "click",
            key: "new3"
        }]
    }]
}

自定义菜单生成的格式，文档上有，如上配置，会生成三个主菜单，第三个菜单下有3个图文子菜单。第一个菜单是一个连接，url地址是我们自己的h5页面地址。

可以看到我们设置了好多click类型菜单，都是一个唯一的key值。那么我们怎么根据不同的click菜单的key值进行响应呢。

回想笔记1中，我们写好了微信服务器通信的post接口，接收微信服务器推送的消息。我们在那里判断了事件类型，如果事件类型是click，那么我们以click的key值为准来进行处理，如果是view或者其他的事件，就用原事件类型处理。

代码如下：

//    如果是click事件，用事件key值来触发响应函数
var eventName = body.Event[0] === \'CLICK\' ? body.EventKey[0]: body.Event[0];
//    一个对象，包含了所有的事件响应处理函数
weixinAutoMessage[eventName](body, res)

weixinAutoMessage配置如下：

module.exports = {
  view: function () {
    // 可以进行处理或者无视
  },
  intro: function (body, res) {
    // 返回一个本站介绍的图文
  },
  new1: function (body, res) {
    // 返回new1图文
  }
  // ..雷同
}

这就是自定义菜单和用户点击菜单的交互过程了。

微信发送给我们的body格式中，有来源openId（用户），对象openId（公众号），代表着这个微信事件是用户发给公众号的，然后我们给微信send  对应xml格式的消息让微信服务器知道该干什么。例如：

intro: function (body, res) {
  var xml = {
    xml: {
        ToUserName: body.FromUserName,
        FromUserName: body.ToUserName,
        CreateTime: + new Date(),
        MsgType: \'text\',
        Content: \'这是一个文本消息\'
    }
};

xml = builder.buildObject(xml);
res.send(xml);
}
} 

用户点击intro时，我们回复了一个文本消息，内容是  这是一个文本消息。 这里用了xml2js模块，可以百度一下看看。

xml格式在微信文档很清晰很详细，可以在消息管理- 被动回复消息一页看得到。

其他类型的菜单博主也没用过，也没法记录了。

微信页面授权

微信页面授权的意思就是，如果你需要将用户的openId与某些数据关联起来，你就需要获取一些权限，从而获取到用户的openId并保存，当用户在我们h5页面注册或者做一些需要记录信息的事件时，我们就可以将它的openId到它的数据中。

比如你的页面需要注册，注册时，也要把用户的openId保存到表中，因为后期如果用户在你的网站买了商品或者其他动态，你需要动态的给用户发送购买成功、支付成功等消息，这就需要这个用户的openId才能完成。

微信页面授权的流程在微信文档很清楚，看文档就行了。