让文档参与到你的开发中，帮助你提高效率 - XJZProxy

官网 https://xjzproxy.xjz.pw/zh-cn/

主要功能：

• HTTP/HTTPS/HTTP2/GRPC 请求代理
• 按 host, connection 分组请求历史
• 简单的搜索语言过滤请求历史
• 自动生成接口文档预览
• 自动生成响应数据
• 自动对比请求、响应数据，并显示差异
• 按过滤结果生成相应的错误统计

通常我们合作开发时都是：

商量接口文档 => 使用者自己生成假数据开撸 =>   最对接真实接口，发现不对再改
          \\=> 开发接口                                 //

甚至是

商量接口文档 => 开发接口 => 等接口好 => 发现不对再改接口或文档

最后基本都是接口使用者拿到文档时没有真实接口可以用。真实接口好了后，改着改着真实接口和文档完全不一样了。

此工具就是为了提高这一过程的效率。一个最简单的示例

先在创建项目并写个文档(YAML 格式)

project:
  host: mydomain.com

apis:
  - title: Get a user
    method: GET
    path: /api/v1/users/\d+
    response:
      success:
        http_code: 200
        data:
          id: 1
          name: .t/name

然后就可以通过 XJZProxy 代理来访问了

$ curl http://mydomain.com/api/v1/users/123 --proxy localhost:9898
{"id": 1, "name": "random name"}

当然，在工具中查看渲染好的漂亮文档也是不能少的。更多文档格式请参考 这里

有兴趣的朋友可以在 这里 下载（目前只支持 Mac 与 Ubuntu，其它 linux 系统的包看情况再折腾了)，然后发邮件到 base64 eGllamlhbmd6aGlAZ21haWwuY29t。我会给前 100 名发放永久证书哟。记得带上标题 "XJZProxy 证书申请"，不然我可能注意不到。当然，没有证书的话，也可以享受完整的代理功能及受限的文档代理功能。