TNW-开启公众号开发者模式
简介
TNW: TypeScript(The) + Node.js(Next) + WeChat 微信公众号开发脚手架,支持 http 模块扩展、支持任何 Node.js 的服务端框架(Express、NestJS 等)
安装
NPM 依赖方式
1、下载
$ npm i tnw
2、Express 示例
3、Nest 示例
源码方式
1、下载项目并安装依赖
$ git clone https://github.com/Javen205/TNW.git
或者
$ git clone https://gitee.com/Javen205/TNW.git
$ cd TNW
$ npm install
2、编译并运行
$ npm run build
$ npm run dev
3、完整示例
配置公众号参考
// 亦可以读取配置文件
let apiConfig = new ApiConfig("Javen", "wx614c453e0d1dcd12", "19a02e4927d346484fc70327970457f9");
// 支持多公众号
ApiConfigKit.putApiConfig(apiConfig);
// 开启开发模式,方便调试
ApiConfigKit.devMode = true;
特别说明
支持多公众号配置,如需要可以多实例化
ApiConfig
然后调用ApiConfigKit.putApiConfig(apiConfig)
进行设置。-
ApiConfig
参数说明第一个参数:令牌 Token 可以任意填写
第二个参数:开发者ID appId
第三个参数:开发者密码 appScrect
第四个参数:是否开启加密 encryptMessage 默认值为 false
第五个参数:消息加解密密钥 encodingAesKey 非必须
设置多个公众号配置时默认使用第一个
ApiConfig
切换公众号配置可以调用
ApiConfigKit.setCurrentAppId(appId)
公众号开启开发者模式
TNW 中验证签名的关键接口如下:
WeChat.checkSignature(signature, timestamp,nonce, echostr)
Express 示例如下:
app.get('/msg', (req: any, res: any) => {
console.log('get query...', req.query);
let appId: string = req.query.appId;
if (appId) {
ApiConfigKit.setCurrentAppId(appId);
}
let signature = req.query.signature,//微信加密签名
timestamp = req.query.timestamp,//时间戳
nonce = req.query.nonce,//随机数
echostr = req.query.echostr;//随机字符串
res.send(WeChat.checkSignature(signature, timestamp,
nonce, echostr));
});
Nest 示例如下:
@Get('/msg')
getMsg(@Req() request: Request, @Res() response: Response) {
let appId: string = request.query.appId;
if (appId) {
ApiConfigKit.setCurrentAppId(appId);
}
let signature = request.query.signature,//微信加密签名
timestamp = request.query.timestamp,//时间戳
nonce = request.query.nonce,//随机数
echostr = request.query.echostr;//随机字符串
response.send(WeChat.checkSignature(signature, timestamp,nonce, echostr));
}
特别说明:
- 开发者URL为:
http/https://域名/msg
或者http/https://域名/msg?appId=xxxxx
- 测试号的加密模式必须设置为
false
(上文提到的ApiConfig
第四个参数) - 正式号推荐开启加密模式并设置为
安全模式
本地端口映射工具
推荐使用 FRP 目前Github Start 已超越 2.2w。如有更好的工具欢迎推荐(留言区见)
开源推荐
-
TNW
微信公众号开发脚手架:https://gitee.com/javen205/TNW -
IJPay
让支付触手可及:https://gitee.com/javen205/IJPay - SpringBoot 微服务高效开发
mica
工具集:https://gitee.com/596392912/mica -
Avue
一款基于 vue 可配置化的神奇框架:https://gitee.com/smallweigit/avue -
pig
宇宙最强微服务(架构师必备):https://gitee.com/log4j/pig -
SpringBlade
完整的线上解决方案(企业开发必备):https://gitee.com/smallc/SpringBlade