有木有靠谱的 API 文档管理工具推荐一下？

[InnerPeace715]

[zxfreedom]

rap 了解一些

[bot2020]

swagger/openapi

[ifconfig]

EoLinker 用了都回不去

[cedoo22]

swagger/openapi 基于注解 生成元数据，依赖 swagger api.
不想依赖的话，找 github 开源的，像 smart-doc 这样的，从注释 生成。

[kyuuseiryuu]

上班这么久，感觉啥 API 管理工具都没用。
最终都会变成“后端从代码生成 API 文档给前端查”。
因为后端不想自己去设计 API、写文档，觉得都已经写代码了，直接生成就好了。
也不愿意其他岗位设计 API 然后去实现每个 HTTP 接口。
没能从行政手段上要求接口先行的，啥 API 管理工具都没用。

[liuzhaowei55]

基于 openapi 的 swagger。
现在是手写 openapi.yml 其他基于注释，注解生成的也尝试过，感觉有一定的侵入性，结构上相比生成的也更加简洁一些。
缺点就是代码更新后要手动更新 yml 文件，有滞后性。
不过技术也不是万能的啥问题都能解决，总是需要一些其他手段来辅助才行。

[balabalaguguji]

易文档，很靠谱，easydoc.top

[InnerPeace715]

@kyuuseiryuu 真实 23333

[6167]

showdoc

[MYlyc]

showdoc.cc

[jianyan74]

我用自己写的： https://github.com/jianyan74/RfOnlineDoc

[fanpei0121]

http://rap2.taobao.org/

[UserNameisNull]

@zxfreedom yapi 了解一下

[star7th]

showdoc 挺简单好用的，可以试下 github.com/star7th/showdoc

[ChoateYao]

@fanpei0121 这个很垃圾，一次性把所有接口文档都返回了，每次打开一个项目就要卡半天，项目越大卡的时间越久。

[InnerPeace715]

@star7th 我也看过，，功能还可以，就是觉得界面有点简陋。。我是看脸的人。2333

[takatost]

上次看到 v 站广告推的 coding 的 API 文档，对于我们这种代码直接生成的还挺香的，就是自己配自动生成还有点麻烦。。没错，我就是看颜值的人[doge][doge]

[InnerPeace715]

@jianyan74 优秀。。。

[InnerPeace715]

@takatost 同道同道。。

[star7th]

@InnerPeace715 见仁见智。很多人喜欢这种简洁风的。已经累积不少用户了。