常用的接口文档工具

本文比较了Swagger和YApi两种接口文档管理工具。Swagger集成于Java项目中,虽然文档维护性高但对代码入侵性强;而YApi作为独立工具,具备mock功能,但需后端额外维护。尽管YApi增加了维护成本,其友好对接文档对前端更为有利。
摘要由CSDN通过智能技术生成
  • swagger, 集成在 java 项目里, 可维护性高, 直接在代码里写文档, 不过带来的也是对代码入侵性高, 整个项目 Controller / Model 代码文件包含大量 swagger 注解
  • yapi 独立的专门的接口文档管理工具, 有 mock 功能, 目前由百度维护, 后端人员需要单独维护接口文档, 增加维护成本, 可能代码改变了, 接口文档更新不及时

个人比较推荐 yapi, 虽然后端需要单独维护接口文档, 不过能为前端开发人员提供更友好的对接文档

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值