接口文档神器YApi

42次阅读

共计 1604 个字符,预计需要花费 5 分钟才能阅读完成。

什么是 YApi

github: https://github.com/YMFE/yapi

官网上是这么介绍的:YApi 是一个可本地部署的、打通前后端及 QA 的、可视化的接口管理平台 https://hellosean1025.github….

可以这么说 YApi 兼具 swagger,rap2,postman 的各项优点

why YApi

如果你想要一个好用的接口管理平台,那么你需要 YApi 或 swagger。YApi 支持各种数据导入,实现无缝迁移。

如果你想 mock 接口,那么你需要 YApi 或 rap2。

如果你想做接口自动化测试,那么你需要 YApi 或 postman。

如果你担心数据放在其他平台不安全,那么你也需要 YApi。YApi 支持本地化部署。

此外,YApi 还有很多特性。

这么优秀,难道你还不准备用吗?

YApi 有哪些功能特性

  • 可视化接口管理
  • 数据 mock
  • 自动化接口测试
  • 数据导入(各种,包括 swagger、har、postman、json、命令行)
  • 权限管理
  • 支持本地化部署
  • 支持插件
  • 支持二次开发

内网部署

如果只想先看看,可以跳过此节,直接使用官方 demo http://yapi.demo.qunar.com/

这里需要您的环境满足

  • nodejs(7.6+)
  • mongodb(2.6+)
  • git

使用 yapi-cli 工具,部署 YApi 平台是非常容易的。执行 yapi server 启动可视化部署程序,输入相应的配置和点击开始部署,就能完成整个网站的部署。部署完成之后,可按照提示信息,执行 node/{网站路径 /server/app.js} 启动服务器。在浏览器打开指定 url, 点击登录输入您刚才设置的管理员邮箱,默认密码为 ymfe.org 登录系统(默认密码可在个人中心修改)。

不想看字,没关系,直接在命令行输入一下命令, 接着按提示一步步就可以了

npm install -g yapi-cli --registry https://registry.npm.taobao.org
yapi server

???? 看截图

我们按照提示进入安装目录,后执行以下命令

node vendors/server/app.js

然后打开 http://localhost:3000/, 可以看到跟官方 demo 一样的界面。

至此,我们已经本地部署好服务里。????

可视化的接口管理

接口管理页面包括预览、编辑、运行和高级 mock, 这样看是不是很清爽????

数据导入

yapi 支持 swagger、HAR、postman、json、命令行五种导入

这里以 HAR 为例: 我们先打开开发者工具,然后打开一个网站:如 美团外卖 https://h5.waimai.meituan.com…

如图:点击下载

接下来,如图

导入成功后,我们就多了几个接口了,是不是很完美 ????

数据 mock

yapi 的 mock 包括很多种

mock 请求参数和返回参数

如图 yapi 提供给我们两种 mock 参数的形式

这里我们把 image mock 成图片

点击上图链接

这里我们成功 mock 了一个接口

想想是不是经常遇到后端接口没有 ready 的情况,现在有了 yapi 是不是一切都迎刃而解了呢????

想了解更多,请查看官方文档 https://hellosean1025.github….

高级 mock

点击高级 mock,这里我们加了一个字段

现在来试试看吧

是不是很爽?

全局 mock 脚本

自动化接口测试

这里我们用 cnode 为例,接口 1:/topics 接口 2:/topic/:id, 其中接口 2 中的 id 由接口 1 返回

添加一个叫 cnode 的项目,注意设置好域名

再导入两个 cnode 接口

运行,没有问题

下面???? 是重点

下面开始关联两个接口,即从接口 1 返回的数据中获取 id, 并赋值给接口 2 的参数

点击更新

开始测试或者服务端测试

状态 pass, 查看测试报告

今天就介绍到这里。

更多文章请关注 https://github.com/abc-club/f…

喜欢请 star

喜欢请 star

喜欢请 star

正文完
 0