为什么要接口管理软件？？？

2019独角兽企业重金招聘Python工程师标准>>>

git 现在基本所有公司都在使用，我们团队的接口管理方式就是基于git，使用markdown编写，没有倾入性，也不需要搭建什么服务器，只需要团队间约定好接口文档格式。

• 定义接口文档格式，如

这个markdown编辑器竟然不支持表格

### 获取聊天室 getChatRoom

    **入参说明**
      |    参数          | 类型   | 必填 | 说明       |
      | ------------- | ------ | ---- | ---------- |
      | room_id       | int    | 是   | 聊天室编号 |

        **出参说明**

     | 参数    | 类型 | 说明     |
    | ------- | ---- | -------- |
    |    room_name     | string | 聊天室名称 |
    | room_type     | string |聊天室类型 |
    | room_property | String |  聊天室属性 |
    | room_head     | String | 聊天室头像 |

• 约定好文档存放在各自 git仓库 目录下， 如 doc/api.md

• 写个简单的web服务器，通过配置 可以从各个仓库拉取 文档内容

  下图是我们自己的一个简单的接口阅读界面

  

• 对接口开发来说，写api是必要的工作，写完只需要提交git即可，前端同事刷新接口界面，最新api一览无余

• 这种方式也有明显短板

  1. 没有权限验证
  2. 没有流程化测试用户

  不过对于创业团队来说，上面两点可以忽略吧，效率是关键！

转载于:https://my.oschina.net/jianfengz/blog/1603166