6月22日，上海·源创会，云技术专场火热报名中

forked from 来贝科技 / 微信API网关

加入 Gitee

与超过 1200万开发者一起发现、参与优秀开源项目，私有仓库也完全免费：）

克隆/下载

README.md 4.21 KB

微信API网关
=======

一、功能说明
------
本项目是基于koa2框架实现的API网关，使用koa2框架的中间件机制提供插件功能。

通过使用微信公众号、服务注册&发现、反向代理等等插件的组合，来有效解决来自不同客户端和服务器请求的统一接入、分发、监控等问题。

支持自定义插件。

![Image text](https://gitee.com/libfintech/wechat_api_gateway/attach_files/download?i=153385&u=http%3A%2F%2Ffiles.git.oschina.net%2Fgroup1%2FM00%2F04%2F5B%2FPaAvDFtZnnyAZHyjAAB9MkCCyaE334.png%3Ftoken%3D06ccf8bf7a1a1df9200378933afc1230%26ts%3D1532599932%26attname%3Dnet.png)

---------------------------------

二、环境说明
------
[NodeJS v8.x.x](https://nodejs.org/en/)

---------------------------------

三、插件说明
------
**1. 原理说明**

接收请求后，通过管道机制，把请求、响应、会话、日志等对象封装成管道对象，逐一传给每个插件，每个插件都是单一职责的，一项功能由多个插件的组合来实现，并且可以调整插件的组合来实现不同的功能，例如，[微信网关](https://gitee.com/libfintech/api_gateway_plugin/tree/master/wx_gateway)插件只负责微信消息格式的转换，配合[转移请求](https://gitee.com/libfintech/api_gateway_plugin/tree/master/transfer)和[反向代理](https://gitee.com/libfintech/api_gateway_plugin/tree/master/proxy)插件，完成分发请求至不同服务器的功能

下图为管道机制原理图，其中必须[配置和启用](https://gitee.com/libfintech/wechat_api_gateway/blob/master/app_config.js.example)反向代理（proxy）插件

![Image text](https://gitee.com/libfintech/wechat_api_gateway/attach_files/download?i=155165&u=http%3A%2F%2Ffiles.git.oschina.net%2Fgroup1%2FM00%2F04%2F6D%2FPaAvDFte1IeAeRTrAAAiVj3Jsmk398.png%3Ftoken%3D49ac450ba07dd38e27c1029e114b6f2f%26ts%3D1532941447%26attname%3Dpipeline.png)

**2. 使用说明**

参考[API网关插件库](https://gitee.com/libfintech/api_gateway_plugin)

---------------------------------

四、应用配置说明
--------
复制[app_config.js.example](https://gitee.com/libfintech/wechat_api_gateway/blob/master/app_config.js.example)为app_config.js，保存到项目根目录中

example中已配置好的插件如下：
- [日志追踪](https://gitee.com/libfintech/api_gateway_plugin/tree/master/log_trace)
- [IP白名单&黑名单](https://gitee.com/libfintech/api_gateway_plugin/tree/master/ip)
- [微信网关](https://gitee.com/libfintech/api_gateway_plugin/tree/master/wx_gateway)
- [转移请求](https://gitee.com/libfintech/api_gateway_plugin/tree/master/transfer)
- [反向代理](https://gitee.com/libfintech/api_gateway_plugin/tree/master/proxy)
- [微信网关响应](https://gitee.com/libfintech/api_gateway_plugin/tree/master/wx_gateway_response)

具体配置参数如下：

<table>
    <tr>
        <td>port</td>
        <td>应用端口</td>
    </tr>
    <tr>
        <td>log</td>
        <td>
            <div>rootPath：日志根路径，可自定义，如，/xxx/xxx/wechat_api_gateway</div>
            <br/>
            <div>日志追踪id键，可自定义，下面三个取值为Spring Cloud Sleuth的默认值</div>
            <div>traceIdKey：x-b3-traceid,</div>
            <div>spanIdKey：x-b3-spanid,</div>
            <div>parentSpanIdKey：x-b3-parentspanid</div>
        </td>
    </tr>
    <tr>
        <td>runningMode</td>
        <td>运行模式，单机模式（standalone）、集群模式（cluster）</td>
    </tr>
    <tr>
        <td>mpConfigName</td>
        <td>公众号配置名称，单机模式时，为配置文件名，集群模式时，为redis key</td>
    </tr>
    <tr>
        <td>redis</td>
        <td>
            <div>redis配置，单机模式时，忽略，集群模式时，必须配置</div>
            <br/>
            <div>ip: IP地址</div>
            <div>port：端口</div>
            <div>pass：密码</div>
        </td>
    </tr>
    <tr>
        <td>plugins</td>
        <td>
            <div>插件配置列表，配置顺序决定触发顺序</div>
            <br/>
            <div>path：插件路径</div>
            <div>config_path：插件配置目录</div>
            <div>enable：是否启用</div>
        </td>
    </tr>
</table>

一键复制编辑原始数据按行查看历史

提交于 2018-07-30 18:36 . update readme

微信API网关

一、功能说明

本项目是基于koa2框架实现的API网关，使用koa2框架的中间件机制提供插件功能。

通过使用微信公众号、服务注册&发现、反向代理等等插件的组合，来有效解决来自不同客户端和服务器请求的统一接入、分发、监控等问题。

支持自定义插件。

Image text

二、环境说明

三、插件说明

1. 原理说明

接收请求后，通过管道机制，把请求、响应、会话、日志等对象封装成管道对象，逐一传给每个插件，每个插件都是单一职责的，一项功能由多个插件的组合来实现，并且可以调整插件的组合来实现不同的功能，例如，微信网关插件只负责微信消息格式的转换，配合转移请求和反向代理插件，完成分发请求至不同服务器的功能

下图为管道机制原理图，其中必须配置和启用反向代理（proxy）插件

Image text

2. 使用说明

参考API网关插件库

四、应用配置说明

复制app_config.js.example为app_config.js，保存到项目根目录中

example中已配置好的插件如下：

具体配置参数如下：

port	应用端口
log	rootPath：日志根路径，可自定义，如，/xxx/xxx/wechat_api_gateway 日志追踪id键，可自定义，下面三个取值为Spring Cloud Sleuth的默认值 traceIdKey：x-b3-traceid, spanIdKey：x-b3-spanid, parentSpanIdKey：x-b3-parentspanid
runningMode	运行模式，单机模式（standalone）、集群模式（cluster）
mpConfigName	公众号配置名称，单机模式时，为配置文件名，集群模式时，为redis key
redis	redis配置，单机模式时，忽略，集群模式时，必须配置 ip: IP地址 port：端口 pass：密码
plugins	插件配置列表，配置顺序决定触发顺序 path：插件路径 config_path：插件配置目录 enable：是否启用

马建仓 AI 助手

尝试更多

代码解读

代码找茬

代码优化

NodeJS

1

https://gitee.com/iceyicey/wechat_api_gateway.git

git@gitee.com:iceyicey/wechat_api_gateway.git

iceyicey

wechat_api_gateway

微信API网关

master