建立文档地址
新建分组
在多组同时使用时,可以按照小组对文档进行分类。
在分组中建立项目
在小组内新建项目文件夹。
进入项目后添加分类
在项目中按照业务类别新建分组。
编写接口文档
在编写接口文档的过程中,有四种方式。分别为手动编写,从postman导入,从swagger导入,通过idea生成。这样大大丰富了在日常使用中的灵活程度。下文将一一介绍。
手动编写
这种方式就是手动在系统中填写,比价繁琐。
在编辑中手动填写。
导入postman文档
导出文档
首先从postman中导出json文档。注意,这里需要选择0选项。
导入文档
导入上文的json文件。
使用swagger导入
我们也可以选择同步swagger的文档,首先选择同步模式。url为swagger地址例http://ip:8001/system/v2/api-docs。当同步完成后,可以在页面中看到已经导入的接口文档。
使用idea插件
同时也可以连接idea通过配置生成接口文档。
安装插件
获取token
每个项目都有一个token,所以多项目的token是不同的。
在idea中配置
按照说明配置即可。
生成
在接口上点击idea-yapi即可生成。
文章为作者独立观点,不代表观点
浮沉2023-02-02
上了数据复盘的股票,都很惨。尤其是点名推荐的,经常是第二天就疯狂割韭菜。今天点名安妮股份了,估计明天这股票要暴跌了