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

讨论 未结 34 55
zhuwd
zhuwd 会员 2022年6月28日 01:28 发表
收藏(0)  分享
相关标签: 灌水交流
注意:本文归作者所有,未经作者允许,不得转载
34个回复
  • yekern
    2022年6月28日 01:28
    Apifox 或者 Apipost 直接调试 然后网页访问文档 还能加密
    0 0
  • THESDZ
    2022年6月28日 01:28
    个人建议是找个支持 openapi(swagger3)导入的框架
    0 0
  • THESDZ
    2022年6月28日 01:28
    优势是:1.代码即文档,减少工作量。2.标准格式外部工具很多,例如导出 word ,pdf ,markdown ;生成 sdk 等。
    0 0
  • oyp
    2022年6月28日 01:28
    我用 wolai 编辑 API 文档,不用想那么多,写起来贼流畅。虽然不能直接运行(我手动运行一样的)和不能自动生成结构(把返回的数据粘贴过去,看 JSO 也能看出来,没必要生成) 图 1: 图 2:
    0 0
  • jmllx1963
    2022年6月28日 01:28
    apifox 可以通过 URL 直接导入 openAPI3 的接口和数据模型 还是很方便的
    0 0
  • abc0123xyz
    2022年6月28日 01:28
    别写什么文档注释,提高竞争力,防止被优化(狗头)
    0 0
  • d119
    2022年6月28日 01:58
    postman 不也可以吗
    0 0
  • linauror
    2022年6月28日 01:58
    个人目前用的比较爽的是用注释导出 swagger ,然后 yapi 自动定时同步 swagger.json (手工导入会导致结构错乱,不知道咋回事)
    0 0
  • ychost
    2022年6月28日 01:58
    ApiPost 好用,还能一键生成 HTML/Markdown 文档,唯一不爽的就是老是在更新!
    0 0
  • flowerains
    2022年6月28日 01:58
    Apifox ,apiPost 但是从团队协作的程度上来看我觉得 eolink 更有潜力
    0 0
  • wolfie
    2022年6月28日 01:58
    showdoc ,导出不太方便(可能版本问题)。/t/842583 _都不用 ApiPost ,可以搜一搜过去在 v2 上的恶心推广。
    0 0
  • balabalaguguji
    2022年6月28日 01:58
    不废话,看效果先: 还可以做手册,自定义域名,看效果: 官网:
    0 0
  • southsala
    2022年6月28日 01:58
    月经贴,能选择的就那么几个,yapi 、swagger 、showdoc 、apifox
    0 0
  • balabalaguguji
    2022年6月28日 01:58
    #22 你不试下易文档,个人觉得比你说的这几个都好太多了
    0 0
  • legiorange
    2022年6月28日 03:27
    强推 swagger+postman. swagger 非常方便本地调试,如果团队一起维护一个 postman ,说实话体验是真的不错。 在大型系统中用 postman 的话比单纯使用 swagger 要舒服,正式环境我会关闭 swagger ,使用 postman 调。apipost 和 apifox 我都用过,公司也掏钱了,实际体验并没有 postman 丝滑,可能和我个人习惯有关系。 语雀和 wolai 都是在线的文档,考虑到隐私性我放弃了使用。
    0 0
  • nekoneko
    2022年6月28日 08:56
    showdoc 不能自己部署服务端的接口文档工具都是垃圾
    0 0
  • Saxton
    2022年6月28日 08:56
    Apifox 一直在用,缺点就是每个版本新加的功能很多,但改动也很大
    0 0