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 一样加注解
楼主本来是 Python 程序员,毕业到现在干了六七年了, 其实最近大环境,你我大家心里也都清楚, 我寻思着,能不能从自媒体方向突破一下自己, 然后就研究了一下最近的热点,抄别…
不管是 aws 还是阿里云等境内云厂商,云数据库都需要绑定一个性能比较不错的实例,每个月开销大概至少要 100 人民币 这比我自己同等价位买个云服务器,自己搭建,有什么优势吗?…
经常需要在 1080 分辨率使用默认缩放比例,但是需要在 4k 下使用 170%缩放比例 每次去切换都很麻烦,从网上下载了一个 HRC 的软件可以固定在任务栏快速切换分辨率,…
合速度