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😂

4696 次点击
所在节点    程序员
90 条回复
rookie2luochao
14 小时 18 分钟前
@rockycc yapi 国产里面绝对算很牛逼的了,不知道为什么弃坑了?
Akagi201
13 小时 55 分钟前
@rookie2luochao #77 目前看到 apidog 相比国内版, 有免费版的团队最多 4 人限制, 多了要付费.
我目前还没用到导出功能. 主要设计跟测试上. 我是 mac m1max 没遇到卡过.
rookie2luochao
12 小时 57 分钟前
@Akagi201 它们这种都是 api 托管吧,便于工作空间合作收费,不愿意花钱、追求隐私安全性的还是就 swagger
shubuqi
12 小时 17 分钟前
推荐一个良心作品,完成度极高前后端都开源的工具
官网: https://online.jobtool.cn/
Github: https://github.com/trueleaf/moyu
crackidz
11 小时 35 分钟前
redoc 有付费版本的,弃坑可能性不大。当然,功能肯定不及付费版本就是了
swagger-ui 其实功能挺完善的了,也没什么问题,不过做文档的话多少有点 UI 上有问题,更方便测试
rapi 没用过,看上去挺不错的样子
openapi-ui 只能说不在审美上,尤其是有大的有小的元素还密集...
rookie2luochao
10 小时 35 分钟前
@crackidz 🥹我就是 openapi-ui 作者,我还是前端,我。。。,rapi 也是借鉴了很多 swagger-ui 设计,连最难用的接口折叠展示都保留着的,其实抄它们的设计也可以,可是当时我并不想啊,求 issue 提点改进意见
rookie2luochao
10 小时 35 分钟前
@shubuqi 已经没啥更新动态了?
Bingchunmoli
10 小时 32 分钟前
@rookie2luochao 看起来和 swagger 没有区别,还要用服务器不是内嵌
rookie2luochao
10 小时 31 分钟前
@Bingchunmoli 还要用服务器不是内嵌是什么意思,上面的所有文档都是可以接入到后端服务上面的
Bingchunmoli
9 小时 9 分钟前
@rookie2luochao 官方插件要么推送给 apifox 要么单独自托管。

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

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

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

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

© 2021 V2EX