Swagger经常被人吐槽界面不够好看、功能不够强大,其实有很多工具可以和Swagger结合使用,结合之后就会变得非常好用。最近发现YApi也很好用。最近体验了一把YApi,发现确实不错!
1. YApi简介
YApi是高效、易用、功能强大的API管理平台,旨在为开发、产品、测试人员提供更优雅的接口管理服务。YApi在Github上已累计获得了18K+Star,具有优秀的交互体验,YApi不仅提供了常用的接口管理功能,还提供了权限管理、Mock数据、Swagger数据导入等功能,总之功能很强大!
2.安装
2.1 环境准备
本地部署YApi需要先安装nodejs和MongoDB,我们先把它们安装好。
- 安装nodejs,直接下载安装包双击安装即可,这里安装的是12.14.0版本,下载地址:https://nodejs.org/dist/v12.14.0/node-v12.14.0-x64.msi;
- 安装MongoDB,这里安装的是4.2.5版本。
2.2 安装yapi-cli
yapi-cli是YApi官方提供的安装工具,可以通过可视化界面来部署YApi服务,非常方便!
- 使用npm命令来安装yapi-cli:
npm install -g yapi-cli --registry https://registry.npm.taobao.org
安装成功后控制台输出如下内容:
- 安装成功后使用yapi server命令来启动YApi的可视化部署界面。
yapi server
ps:部分人在执行之后提示yapi 不是内部或者外部命令,只需要把yapi所在的目录添加到系统环境边两种就可以了。
2.3 安装YApi
- 通过可视化部署界面安装YApi服务,访问地址:http://localhost:9090
- 安装完成后会输出如下信息,提示YApi的默认管理员账号密码及访问地址;