抛弃 swagger? 这款零成本的 API 文档生成工具，已支持上传到 Yapi, Rap2, Eolinker 多个平台

2021-08-29 15:13:34 +08:00
 MarioLuo

Yapi X

造了个轮子，从源码解析标准 Javadoc 文档和 spring 注解生成文档, 上传到 YApi, Rap2, Eolinker, Copy as cURL.

重点！零学习成本，代码即文档，支持多种 API 管理平台

亮点！开箱即用，账户密码登录，易于二次开发

欢迎试用，喜欢的点个星星支持

4334 次点击
所在节点    Java
27 条回复
NoUltimate
2021-08-30 11:11:34 +08:00
可以指定自己搭建的 rap2 吗？
MarioLuo
2021-08-30 13:02:10 +08:00
@NoUltimate 可以指定，如果未配置相关账户密码，点击上传时，会自动弹出提示输入相关信息
NoUltimate
2021-08-30 14:11:19 +08:00
@MarioLuo 我找到配置的地方了，不过上传报错了 Expected a string but was BEGIN_OBJECT，和我 rap 版本（ 2.3 ）有关系吗，注释只加了类开头和请求开头
MarioLuo
2021-08-30 15:34:02 +08:00
@NoUltimate Rap2 最新版本才 2.2.3, 可以用淘宝 rap2 官方的测试下，如果还有问题可以在 issues 上沟通下，控制台会打印完整的堆栈信息，另外可以确认下本机能否正常连接到内网 rap2
Gunn27
2021-08-30 16:32:21 +08:00
还是用 ApiCat 吧
liaoberlin
2021-08-31 10:15:52 +08:00
如果也能支持解析 swagger 注解或者 javadoc 跟 swagger 注解混用的解析就完美了
MarioLuo
2021-09-01 09:44:20 +08:00
@liaoberlin 有支持 swagger， 不过目前还没测试过，下个版本会支持

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://tanronggui.xyz/t/798651

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX