- swagger, 集成在 java 项目里, 可维护性高, 直接在代码里写文档, 不过带来的也是对代码入侵性高, 整个项目 Controller / Model 代码文件包含大量 swagger 注解
- yapi 独立的专门的接口文档管理工具, 有 mock 功能, 目前由百度维护, 后端人员需要单独维护接口文档, 增加维护成本, 可能代码改变了, 接口文档更新不及时
个人比较推荐 yapi, 虽然后端需要单独维护接口文档, 不过能为前端开发人员提供更友好的对接文档
个人比较推荐 yapi, 虽然后端需要单独维护接口文档, 不过能为前端开发人员提供更友好的对接文档