swagger-ui, redoc 好像都快弃坑了, rapi 作者似乎却干劲十足, openapi-ui 作者躺平式更新,大家现在都在用什么 api 文档软件,经济下行,开源弃坑的好像越来越多?
这里主要是说一些开源免费的 openapi 规范 UI 文档, 那些一上来就无脑各种喷的还请嘴上留情,好歹也算为爱发电,大家都不容易,找点杂事干着也是挺好的
不得不说 apifox 确实是个好东西,目前来看也没咋收费,可是它好像只对 java kotlin 友好,而且我总感觉它好卡,它很多强大的功能我都没有使用过,关键是它为啥必须手动导出 openapi.json 啊,这让想直接根据配置生成 ts http 客户端的前端小伙伴非常蛋疼
目前来看这 4 个包的更新情况:
swagger-ui:功能完善,没咋更新了,就是 UI 体验很差
redoc: 没咋更新了,它竟然不支持测试接口,有点费解
rapi: 作者重新回归,更新活跃,总感觉它的代码阅读起来费劲,不知道是不是我太菜了
openapi-ui: UI 使用良好,使用的最新技术栈构建,代码可读性可维护性高,作者一直在躺平式更新,因为用户太少,没人提 bug😂
跟经济下行无关,行情好的时候也有不少这样的弃坑项目。多半是作者心思已经不在这项目上了吧
可是并没有新的接口规范出来,我看作者们 github 好像都没啥更新动态了
swagger 看上去很美好 但是已经复杂到我不想用的程度了 各类语言框架的支持也不完善
还在用着 yapi ,蛮多 bug 的,但找不到替代品
用 springdoc 吧,虽然仅仅套个 swagger-ui ,但内部实现还是紧跟 springboot 的节奏的。
我们 java 类项目用的 apifox+apifox idea ,对代码侵入还好,后端接受性还不错,不用写很多注解
这个也还行 github.com/stoplightio/elements
yapi 不是很早就弃坑了吗,用这个的目前不多了
这个看着不像接口文档类解决方案啊
各类语言框架的支持,swagger 官方并没有做啊,都是社区做的
现在用 apifox ,目前使用体感还好,没有用到付费的服务
后端是 java 的话,用这个玩意确实不错,免费的够用了,但是有一点也还没有找到解决办法,就是 apifox 自动同步 openapi.json
最好的 api 文档莫过于 protobuf
Scalar
这玩意是往付费运营的
个人觉得, 最好的 api 是特么的把后端的项目 git 权限给劳资打开,现代后端项目全特么有 mvc 分层了, 详细业务逻辑我看不懂而已, 控制器定义逻辑和参数表我看得懂呀...
后端说:谁特么跟我把数据库权限,sql 权限放开,老子改个表都不行吗?老子改个数据还得写 sql ,还得负责人审批,老子 xxxxxxx00000000
这是什么高级玩意,容我看看😊
knife4j 很好用
knife4j 应该赶不上 apifox, javaer 说用这个玩意还不错,比 swagger/openapi 舒服,它是自动解析代码的,精确的信息也需要像 swagger/openapi 一样加注解
大概 20 年前,问道那款端游,一种情怀。 如果我愿意花二十万复刻一套。 应该是逆像一套这种逻辑 资金方面 20 够吗? 有谁愿意接手来做,可以找我聊聊。VX:kongdong…
目前生活用主力机 iPhone 13pm ,下个月到新的城市工作,打算新办张当地的电话卡和新买部工作机。大致的需求如下:1.能够通话录音,除了电话,必须要有微信 qq ,钉钉,…
Groovy是一个基于 Java虚拟机的敏捷 动态语言。构建在强大的Java语言之上 并 添加了从Python,Ruby和Smalltalk等语言中学到的 诸多特征。为Java…