灰气球

灰气球

微信公众号后台服务 WeixinMPSaaS

231
2021-03-31

介绍

微信公众号后台服务SaaS, 支持微信公众平台(订阅号、服务号、企业号、小程序).

  • 支持多个微信公众号配置
  • 动态更新配置

本项目仍在不断迭代开发中,遇到问题请提 issues , 谢谢配合.

代码仓库

软件架构

本项目基于 Spring Boot 构建, 对接微信公众号Api.

安装教程

  • 创建MySQL数据库
CREATE SCHEMA `weixin_mp_saas` DEFAULT CHARACTER SET utf8mb4 ;
  • 生成可执行jar包
mvn clean package -Dmaven.test.skip=true
  • 启动服务
java -jar weixin-mp-saas.jar
  • 配置项
    • server.port 服务端口号, 默认是 8080
    • mysql.host 默认是 127.0.0.1:3306
    • mysql.username 默认是 root
    • mysql.password 默认是 toor
    • mysql.database.name 数据库名称 weixin_mp_saas
java -jar -Dserver.port=8080 -Dmysql.host=localhost:3306 -Dmysql.username=root -Dmysql.password=toor -Dmysql.database.name=weixin_mp_saas weixin-mp-saas.jar

使用说明

注意:需先在微信公众平台完成"IP白名单"设置

新增微信公众号配置

  • 调用Http接口
    • 开发者密码(AppSecret) : “secret”
    • 消息加解密密钥 : “aesKey”
    • 开发者ID(AppID) : “appid”
    • 令牌(Token) : “token”
    • 应用标识 : “appTag”

appTag与微信无关, 是本项目用于标识应用的, 因为本项目可支持多个微信公众号.
appTag 就是用来区别不同公众号的一个配置项.
假设 appTag 设置为 “WeixinMPSaaS”, 那么在公众号基本配置页面配置如下 :

Http请求示例 : curl命令

curl --location --request POST 'http://127.0.0.1:8080/config/weixin/openapi/add' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appTag":"xx",
    "secret":"xx",
    "aesKey":"xx",
    "appid":"xx",
    "token":"xx",
    "verifyValue":"xx",
    "verifyKey":"xx"
}'

更新微信公众号配置

大多数请求参数与"新增微信公众号配置"接口一样,不再赘述.
openapiConfigVerify.secret 用于验证,当其等于原有配置的secret,才允许更新.

curl --location --request POST 'http://127.0.0.1:8080/config/weixin/openapi/update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appTag":"xx",
    "secret":"xx",
    "aesKey":"xx",
    "appId":"xx",
    "token":"xx",
    "verifyValue":"",
    "verifyKey":"",
    "openapiConfigVerify":{
        "secret":"xx"
    }
}'

效果演示


其他配置

nignx 反向代理

server {

	# 极简配置, 需要其他配置项自行补上
	listen 80;

	location /weixin-mp-saas/ {
		proxy_pass http://127.0.0.1:8080/weixin-mp-saas/;
	}
}

关闭跨公众号搜索能力

secret 用于验证,当其等于原有配置的secret,才允许更新.

curl --location --request POST 'http://127.0.0.1:8080/weixin-mp-saas/config/weixin/drainage/enable' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appTag":"test",
    "secret":"testSecret",
    "enable" : "false"
}'