使用yapi工具编辑接口文档

相对于swagger来说，yapi页面更加美观，使用上功能也更多了一些，所以操作也相对复杂，上文安装完yapi后，本文将介绍如何使用 yapi。

1.建立文档地址

1.新建分组

在多组同时使用时，可以按照小组对文档进行分类。

2.在分组中建立项目

在小组内新建项目文件夹。

3.进入项目后添加分类

在项目中按照业务类别新建分组。

2.编写接口文档

在编写接口文档的过程中，有四种方式。分别为手动编写，从postman导入，从swagger导入，通过idea生成。这样大大丰富了在日常使用中的灵活程度。下文将一一介绍。

1.手动编写

这种方式就是手动在系统中填写，比价繁琐。

在编辑中手动填写。

2.导入postman文档

首先从postman中导出json文档。

注意，这里需要选择1.0选项。

导入上文的json文件。

3.使用swagger导入

我们也可以选择同步swagger的文档，首先选择同步模式 。url为swagger地址 例 http://ip:8001/system/v2/api-docs。

当同步完成后，可以在页面中看到已经导入的接口文档。

4.使用idea插件

同时也可以连接idea通过配置生成接口文档。

每个项目都有一个token，所以多项目的token是不同的。

按照说明配置即可。

在接口上点击idea-yapi即可生成。

IDE

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。