java---自动api文档生成Yapi

java---自动api文档生成Yapi


开发过程中,接口文档是前后端,测试交互的依据,文档更新的及时性和准确性很重要。

word文档缺点:

  1. 手动编写,出错性很高
  2. 文档可读性差,考验编写者的耐心
  3. 无法在线调试
  4. 及时性差

swwager文档缺点:

  1. 文档可读性差
  2. 针对需要带授权token的请求,无法在线调试
  3. 无法导入和导出api文档
  4. 测试和开发无法在文档上沟通

Yapi解决以上所有问题,yapi可以支持java apidoc ,兼容swwager,只需要idea安装对应插件,就可以实现右键点击upload to yapi,自动生成api接口文档
java---自动api文档生成Yapi
java---自动api文档生成Yapi
java---自动api文档生成Yapi
Yapi使用,官方教程:https://hellosean1025.github.io/yapi/documents/index.html