未分類 22 4 月 2020 有木有靠谱的 API 文档管理工具推荐一下? 有木有靠谱的 API 文档管理工具推荐一下? 資深大佬 : InnerPeace715 58 rap 了解一些 大佬有話說 (19) 資深大佬 : zxfreedom swagger/openapi 資深大佬 : bot2020 EoLinker 用了都回不去 資深大佬 : ifconfig swagger/openapi 基于注解 生成元数据,依赖 swagger api.不想依赖的话,找 github 开源的,像 smart-doc 这样的,从注释 生成。 資深大佬 : cedoo22 上班这么久,感觉啥 API 管理工具都没用。最终都会变成“后端从代码生成 API 文档给前端查”。因为后端不想自己去设计 API、写文档,觉得都已经写代码了,直接生成就好了。也不愿意其他岗位设计 API 然后去实现每个 HTTP 接口。没能从行政手段上要求接口先行的,啥 API 管理工具都没用。 資深大佬 : kyuuseiryuu 基于 openapi 的 swagger。现在是手写 openapi.yml 其他基于注释,注解生成的也尝试过,感觉有一定的侵入性,结构上相比生成的也更加简洁一些。缺点就是代码更新后要手动更新 yml 文件,有滞后性。不过技术也不是万能的啥问题都能解决,总是需要一些其他手段来辅助才行。 資深大佬 : liuzhaowei55 易文档,很靠谱,easydoc.top 資深大佬 : balabalaguguji @kyuuseiryuu 真实 23333 主 資深大佬 : InnerPeace715 showdoc 資深大佬 : 6167 showdoc.cc 資深大佬 : MYlyc 我用自己写的: https://github.com/jianyan74/RfOnlineDoc 資深大佬 : jianyan74 http://rap2.taobao.org/ 資深大佬 : fanpei0121 @zxfreedom yapi 了解一下 資深大佬 : UserNameisNull showdoc 挺简单好用的,可以试下 github.com/star7th/showdoc 資深大佬 : star7th @fanpei0121 这个很垃圾,一次性把所有接口文档都返回了,每次打开一个项目就要卡半天,项目越大卡的时间越久。 資深大佬 : ChoateYao @star7th 我也看过,,功能还可以,就是觉得界面有点简陋。。我是看脸的人。2333 主 資深大佬 : InnerPeace715 上次看到 v 站广告推的 coding 的 API 文档,对于我们这种代码直接生成的还挺香的,就是自己配自动生成还有点麻烦。。没错,我就是看颜值的人[doge][doge] 資深大佬 : takatost @jianyan74 优秀。。。 主 資深大佬 : InnerPeace715 @takatost 同道同道。。 主 資深大佬 : InnerPeace715 @InnerPeace715 见仁见智。很多人喜欢这种简洁风的。已经累积不少用户了。