接口文档是贯穿整个开发项目流程中的规范，前后端开发需要在开发前期进行接口定义并形成文档，测试人员在功能测试和接口测试的环节也需要对这些接口文档进行测试。
然而随着开发版本迭代，很多接口发生了变化或者被废弃，而开发后期几乎不会去更新这种静态文档。因此，我们需要一款接口文档工具对静态文档进行维护。本文会列举与对比两款常用的接口文档工具，希望找到一个长期可维护且轻量便捷的接口文档工具。
这里我们选择国外的 Swagger 与国内的 Eolink 作对比， Swagger 是开发者最常用的接口文档工具之一， Eolink 则是国产接口文档工具中比较有代表性的工具之一。
Swagger ：
Swagger 可以为用户提供生成、描述、调用和可视化 RESTful 风格的 Web 服务。此外，还提供了多种编程语言的前后端分离解决方案。
优势：
1、包含 SwaggerEditor ，它是使用 yaml 语言的 Swagger API 的编辑器，支持导出 yaml 和 Json 格式的接口文件。
2、 Swagger 包含了 SwaggerUI ，它将 Swagger Editor 编辑好的接口文档以 html 的形式展示出来。
3、 Swagger 支持根据定义的接口导出各种语言的服务端或客户端代码。
缺点：
1、由于 Swagger 还不支持自定义接口文档，无法指明某一个功能需要是用什么样的接口，因此对于复杂的功能，像一个功能需要多个模块来配合的情况下，联调测试就会变得十分麻烦。
2、无法测试错误的请求方式与参数，不支持接口的参数分组。
3、 Swagger 的代码侵入性比较强。要让 Swagger 生成接口文档必须要给方法或字段添加对应的注解，是存在代码侵入的。
4、官方文档不够全面。 Swagger 官方针对不同模块提供了不同介绍文档，但缺乏系统介绍，不利于新人学习。
5、 Swagger 的下载和安装使用都是英文界面，需要英语基础水平高，对于国人的使用不友好。
Eolink ：
Eolink 是一款通过接口文档实现前后端同时开发，一键发起 API 测试。当 API 发生变动时可以通知相关人员，实现在线分享、离线导出 API 文档，实现对 API 进行版本管理等多种功能的接口文档工具。
优势：
1、提供网页端服务，打开网页即可使用，可实现各个平台免安装运行。
2、可支持 JS 验证程序，支持 HTTP(S) 、 Websocket(s) 、 TCP 、 UDP 、 SOAP 、 HSF 协议等多种网络协议进行测试。
3、实现测试脚本和测试结果在线管理，并且可以同步分享给协作成员。
4、 Eolink 测试可以模拟后端存在 ，测试报告可以反馈前端在正常情况下进行的正常测试结果。
5、纯中文界面使用，更符合国人的使用习惯。
6、用户可以在 Eolink 社区提出问题，会得到相应回答与更新。
缺点：
1、自定义功能较多，需要一定学习成本。
2、没有压力测试功能。
经过以上对比， Swagger 与 Eolink 各有长处， Swagger 作为老牌的接口文档工具依旧是一个较为规范和完整的框架，全英界面使用起来有时会不适应，相较之下 Eolink 作为一款国产构建 API 生态的文档工具，纯中文界面，且使用方法更符合国人习惯。并含有齐全的文档功能，如文档管理、 API 网关、 API 监控、 API 自动生成等多种功能。 如有兴趣可自行试用：www.eolink.com
