swagger-ui, redoc 好像都快弃坑了, rapi 作者似乎却干劲十足, openapi-ui 作者躺平式更新,大家现在都在用什么 api 文档软件,经济下行,开源弃坑的好像越来越多?

2 天前
 rookie2luochao

这里主要是说一些开源免费的 openapi 规范 UI 文档, 那些一上来就无脑各种喷的还请嘴上留情,好歹也算为爱发电,大家都不容易,找点杂事干着也是挺好的

不得不说 apifox 确实是个好东西,目前来看也没咋收费,可是它好像只对 java kotlin 友好,而且我总感觉它好卡,它很多强大的功能我都没有使用过,关键是它为啥必须手动导出 openapi.json 啊,这让想直接根据配置生成 ts http 客户端的前端小伙伴非常蛋疼

目前来看这 4 个包的更新情况:

swagger-ui:功能完善,没咋更新了,就是 UI 体验很差
redoc: 没咋更新了,它竟然不支持测试接口,有点费解
rapi: 作者重新回归,更新活跃,总感觉它的代码阅读起来费劲,不知道是不是我太菜了
openapi-ui: UI 使用良好,使用的最新技术栈构建,代码可读性可维护性高,作者一直在躺平式更新,因为用户太少,没人提 bug😂

4647 次点击
所在节点    程序员
90 条回复
cccxu
2 天前
scalar ui
rookie2luochao
2 天前
@cccxu 这东西确实做的挺好,但是和 apifox 一样感觉不够简洁,而且他的目标是付费用户
rookie2luochao
2 天前
@cccxu 他们团队这么多人做这个 scalar 文档,经费遭得住吗,收费的文档平台其实应该挺难做的吧,完全不要 api 文档的也很多,而且还有 postman 这些巨头
burymme11
2 天前
ApiFox ,有网页版,有客户端,有 IDEA 插件。全公司后端项目都在用,没啥毛病。
rookie2luochao
2 天前
@burymme11 我们公司也有部分项目在用,确实是不错的,关键是确实不收费,但是除开 java idea 插件,其他语言好像并不支持 idea 插件
stiangao
2 天前
rookie2luochao
2 天前
@stiangao 你不发不知道,原来文档类软件这么卷,简直是红海
stiangao
2 天前
stiangao
2 天前
@rookie2luochao 本来想找一个 apifox 替代品,找出了好多项目,一个比一个🌟多
lepig
2 天前
apifox 确实挺好用,就是太 TM 卡了,16G 内存,开了七八个标签直接占了 1.7G 多。快赶上 ide 了。
rookie2luochao
2 天前
@stiangao apifox 不错啊,都用上 apifox 了,为什么要找替代品
rookie2luochao
2 天前
@lepig 这玩意我也感觉卡得很,功能太多了,但是很多都用不上,反正操作页面不简洁,而且巨卡
fox2081
2 天前
@cccxu #21 试了下很好用,node 和 web 端都是导入 openapi 配置就能直接用,终于能替换掉 swagger-ui 了
rookie2luochao
2 天前
@fox2081 试了下什么很好用,swagger-ui 替换一下现代点的 UI ,其实也好用,轻量且不卡
fox2081
2 天前
@rookie2luochao #34 就是 scalar ui 啊,确实比 swagger-ui 好看多了
Hanser002
2 天前
基于 swagger 生成好了类型就不看 swagger-ui 了,确实不好看也不是很好用,调试直接上 apifox 就行
davin
2 天前
到最后,还是 postman 解君愁
rookie2luochao
2 天前
@fox2081 我看他们有挂收费标准,就没有对比它了,因为它算付费栏目
rookie2luochao
2 天前
@davin postman 确实牛逼啊,有很多人烦登录
fantasy0v0
2 天前
我现在的做法是先在 apifox 设计好,然后再让前后端根据这个文档实现。
有点不太理解 swagger-ui ,用这个的话,一般是后端把注释和代码都写好了,然后再生成成文档给前端看吗?

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

https://www.v2ex.com/t/1079457

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

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

© 2021 V2EX