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 一样加注解
不知道大家有没有这样的感觉, 刚入行的时候比较喜欢读一些新书, 尤其是讲时髦技术的书. 摸爬滚打两三年之后, 大概率会感觉到有个瓶颈期, 这时候读书就比较偏向于选择一些分享经验…
想换个安卓手机,目前用的荣耀 9 ,比较卡。 价格:2000-3500 需求:最好高端芯片机器 屏幕:护眼屏的话最好,支持高刷的话最好,曲面屏的话也不排斥 CPU:最好是高端芯…
留下书名以及你对这本书的评价 活着 推荐些技术书籍,大家都是程序员,其它领域的书先放一放 Kubernetes in Action, 2nd edition 重构 改…