求推荐比较好用的接口文档管理工具?

2022-06-28 08:43:02 +08:00
 zhuwd
主要有两个场景:1.团队内部使用; 2.接口文档导出给第三方对接平台
6621 次点击
所在节点    程序员
43 条回复
jayin
2022-06-28 09:46:20 +08:00
apifox
southsala
2022-06-28 09:54:00 +08:00
月经贴,能选择的就那么几个,yapi 、swagger 、showdoc 、apifox
balabalaguguji
2022-06-28 09:56:14 +08:00
@southsala #22 你不试下易文档,个人觉得比你说的这几个都好太多了
guanhui07
2022-06-28 11:19:38 +08:00
yapi 、swagger 、showdoc 、apifox
2696284032
2022-06-28 11:20:55 +08:00
eolink 是我用过最好用的
legiorange
2022-06-28 11:24:04 +08:00
强推 swagger+postman.
swagger 非常方便本地调试,如果团队一起维护一个 postman ,说实话体验是真的不错。
在大型系统中用 postman 的话比单纯使用 swagger 要舒服,正式环境我会关闭 swagger ,使用 postman 调。apipost 和 apifox 我都用过,公司也掏钱了,实际体验并没有 postman 丝滑,可能和我个人习惯有关系。
语雀和 wolai 都是在线的文档,考虑到隐私性我放弃了使用。
v2eb
2022-06-28 12:32:22 +08:00
knif4j
xsen
2022-06-28 12:39:39 +08:00
yapi
sutra
2022-06-28 13:08:01 +08:00
nekoneko
2022-06-28 16:47:59 +08:00
showdoc
不能自己部署服务端的接口文档工具都是垃圾
ixinshang
2022-06-28 16:50:23 +08:00
showdoc
Saxton
2022-06-28 16:52:25 +08:00
Apifox 一直在用,缺点就是每个版本新加的功能很多,但改动也很大
CathayChen
2022-06-28 17:22:56 +08:00
alen0206
2022-06-28 17:23:46 +08:00
yapi
securityCoding
2022-06-28 17:43:02 +08:00
pb
jeffh
2022-06-28 23:18:36 +08:00
必须 yapi ,搭配 idea 插件,神一般的存在
gclm
2022-06-29 00:57:43 +08:00
@linauror 如何用注解生成 swagger.json 啊,能否分享一下呢?目前感觉你这个方法很棒
linauror
2022-06-29 09:29:35 +08:00
@gclm 如果你用的 golang 的话,可以结合 swaggo ,直接引用结构体和注释来生成 swagger.json ,其他语言应该也有类似的生成工具
cubecube
2022-06-29 10:35:39 +08:00
@THESDZ 很多接口并不能用 openapi 表示呢
wm5d8b
2022-06-29 13:17:26 +08:00
接口文档工具默认就是 HTTP 吗,dubbo 和 grpc 的怎么维护

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

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

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

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

© 2021 V2EX