微信公众账号测试号的nodejs接口接入指南

红太狼 2023-06-24 06:23 241阅读 0赞

小程序中想要用到微信公众号的部分接口功能，先是申请了一个未认证的个人订阅号，结果发现我想要的功能没法用  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70]所以根据微信开发文档的指示，我只能申请一个微信公众账号测试号，测试号能够使用微信公众号里除了支付以外的大部分功能，进入微信公众号测试号申请系统。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 1]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 2]接下来记录一下我用本地的nodejs服务器来接入测试号的接口的过程。

### 一、 填写接口配置信息 ###

如上图所示，需要填写配置信息，填写完成之后，微信服务器就会基于你填的token和服务器接口地址，发送一个`GET`请求到你自己的服务器，然后验证你的服务器是否能返回它所期望的结果，如果结果符合预期就说明配置成功，否则配置失败。以下有几个点提一下：

1.  需要的服务器可以使用内网穿透的方式，用本地服务器来搭建，可参考：[使用NATAPP搭建本地服务器调试微信小程序][NATAPP]
2.  `URL`是你自己服务器的接口，它应该能够正确响应微信发送的token验证
3.  `Token`是用作验证你的服务器是否可用的依据，可以随便填。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 3]
4.  点击了“提交”按钮后，微信服务器会发送一个`GET`请求到你的服务器，GET请求携带的参数如下表所示：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 4]5. 微信服务器会对上述的参数进行加密/校验：  
    ① 将token、timestamp、nonce三个参数按字典序进行排序。  
    ② 将以上三个参数拼接成一个字符串进行sha1加密，生成signature参数。  
    ③ 将以上四个参数添加在GET请求中，一起发送给第三方服务器（我们自己的服务器）。  
    ④ 希望第三方服务器确认此次GET请求来自微信服务器之后，能够原样返回`echostr`参数内容，则判定接入成功，否则接入失败。  
    所以，我们在自己服务器上需要做的就是接受微信服务器的请求后，根据以上流程再做一次同等的加密，再与`signature`参数进行对比，如果对比一致的话，就表示该请求来源于微信，返回`echostr`就行了。

### 二、nodejs本地服务器的校验 ###

npm 安装sha1，不需要多余引入的情况下：

npm install sha1  --save

使用

const sha1 = require('sha1');

其他的在代码中都有比较清楚的注释：

//server.js
    const express = require('express');//引入express框架
    const sha1 = require('sha1');//引入sha1
    const app = express();
    
    app.get('/weChatDevCheck', function(req, res, next){ 
    	console.log("微信开发接口接入测试");
    	const token = "butcher";//测试token,与填写配置信息时的token一致
    	const signature = req.query.signature;//微信加密签名
    	const timestamp = req.query.timestamp;//时间戳
    	const echostr = req.query.echostr;//随机字符串
    	const nonce = req.query.nonce;//随机数
    	console.log(req.query);
    	let oriArray = [];//字典排序拼接
    	oriArray.push(token);
    	oriArray.push(timestamp);
    	oriArray.push(nonce);
    	let original = oriArray.sort().join('');
    	let combineStr = sha1(original);//加密
    	console.log(combineStr);
    	if(signature === combineStr){ //比较
    		res.send(echostr);//返回echostr
    	}else { 
    		console.log('err');
    	}
    	next();
    });
    
    const server = app.listen(80, function(){ 
    	const host = server.address().address;
    	const port = server.address().port;
    	console.log("应用实例",host,port);
    });

启动服务器`node server.js`，使用本地服务器要启动natapp.exe， 然后回到刚刚的测试号接口配置那里，点击“提交”按钮，成功的情况下可以看到后台打印下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 5]接口配置页面也提示配置成功啦！  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 6]写到最后发现，其实我们自己的服务器不对参数进行处理，直接返回`echostr`的内容也可以实现认证的：)

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191220233633151.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20191220233829144.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20191220234534569.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg==,size_16,color_FFFFFF,t_70
[NATAPP]: https://blog.csdn.net/piisabutcher/article/details/103637424
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20191221005017985.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/2019122100084246.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20191221004852144.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20191221005139978.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpaXNhYnV0Y2hlcg==,size_16,color_FFFFFF,t_70