接口测试管理，你不来了解一下？

在平常的开发模式里，前端负责页面和动态脚本的处理，服务端负责业务逻辑和接口的实现。当前端须要服务端提供的接口实现动态数据展现和交时，服务端完成接口开发后会提供一个接口文档给到前端按照文档规范再进行开发。这样模式下每每会出现两种状况： 一种 是往前端开发的进度往与服务端开发的进度不会彻底同步，这就存在了一方等待另外一方的状况，这多少会影响总体项目开发进度； 另外一种 就是当前端对接不一样的服务端人员所开发的接口，若是没有了统一的接口文档规范，每一个人输出的接口文档都不尽相同，在后期对项目接口的更新和维护会是很大的时间成本。

因此颇有必要有一个先后端通用的接口管理平台，简化接口对接和维护的流程。先后端能够经过接口管理平台，制定接口数据和格式，而后经过模拟数据生成假接口，先后端再各自独立开发，直至双方都开发完成后对接真实接口数据进行微调便可。而且经过接口管理平台，开发人员能够更便捷地管理项目全部接口数据。

这里本文将主要认识学习一下目前国内开源较火的接口管理平台 YApi，看如何使用它帮助咱们提升开发效率和便捷对接口的管理。

2、YApi 介绍

YApi 是一个可本地部署的、打通先后端及QA的、可视化的接口管理平台，以开发、产品、测试人员提供更优雅的接口管理服务为目标，该项目由去哪儿网大前端技术团队开源的，托管在 Github 上，已经 9000 多星。

YApi 做为 API 管理平台主要提供三大块功能：

项目管理 ：提供基本的项目分组，项目管理，接口管理功能，成员权限管理

接口管理 ：提供友好的接口文档，支持多人协做接口编辑功能，以及类 Postman 测试工具便于高效调试接口

Mock 服务 ：基于Mock.js，经过随机数据生成，模拟各类接口数据，充分发挥先后端分离的优点。

什么是Mock . js？

Mock . js是 一个模拟数据生成器，帮助前端开发和原型与后端进度分离，减小一些单调，特别 是 在编写自动化测试时。

固然 YApi 还有不少强大的功能，好比自动化测试，插件机制，二次开发等等。

下图是YApi 官方提供了使用 YApi 的工做流程，从这里能够简单了解下如何在平常开发中使用 YApi。

 

3、第一个 YApi

一、登陆注册

使用 YApi 前，必需要先有登陆帐号，因此一开始须要在所搭建的 YApi 网站上注册一个帐号,注册成功就能够用用户名或者邮箱进行登陆。

 

 

注册成功后就会自动登陆进入 YApi 首页，后面再次使用就能够直接用帐号登陆了。

须要注意的是做为新注册的用户，没有任何分组与项目的权限，只能对“公开项目” 的接口进行搜索、浏览 ，此时须要联系平台管理员将你加入对应项目。

下图为一个正常帐户登陆 YApi 首页的基本内容：

 

（1）首页头部展现了当前所在的位置、搜索框、新建项目、查看文档和用户信息。

（2）首页左侧展现分组信息，“分组”是“项目”的集合，只有超级管理员能够管理分组。

（3）首页右侧是分组下的项目和成员列表，点击左侧的某个分组，右侧会出现该分组下的项目和成员信息。

（4）点击项目右上角的星星便可关注项目，关注的项目能够在“个人关注”页面查看。

（5）点击头像进入“我的中心”，容许查看和修改我的信息。

二、项目接口

首先在项目列表选择一个项目进入(若是没有可用的项目， 一种方式是找管理员分配项目权限 ，一种是在左上角点击  "添加项目" 新建一个项目），进入项目后可大体看到以下内容：

 

 

（1）接口列表，展现该项目的全部接口名称，而且按照文件夹分类，默认都在公共分类下，也能够自定义添加分类。

（2）测试集合，用于保存接口运行正常的数据信息和接口状态，便于后续直接使用测试集合中的接口测试。

（3）添加接口，为项目添加接口，默认在公共分类下，须要指定接口名，请求方式和接口路径，保存后自动添加到接口列表下。

（4）用于接口数据的导入导出，便于接口数据的迁移归档。

（5）对项目信息的基本设置，如环境地址，接口路径，Mock 设置等。

如今咱们再来看下一个简单接口的页面展现内容：

 

 

 

 

接口信息框内有四个面板能够切换，分别为预览，编辑，运行和高级 Mock，咱们在 编辑 面板里能够经过接口的请求方式，请求数据，响应数据，接口描述等信息进行编辑，保存后都会在 预览 面板内清晰展现出来，当须要进行接口测试时就须要在 运行 面板里操做，里面的操做方式跟 Postman 很类似，相信使用过 Postman 的小伙伴应该能很快上手。

注意：使用接口测试服务时，若是是 Chrome 浏览器 ，需安装测试加强插件,官方也提供了下载地址和安装教程。

这里有一个小技巧能够分享下：每次进入接口的运行面板，上次使用请求参数都会被状况，每次都须要从新填写，若是请求接口参数一多就十分繁琐；这里咱们能够把测试过的接口经过 保存 按钮加入到测试集合中，后面能够直接在测试集合中找到所记录的接口和有效的请求参数，而且能直接使用。

 

 

高级Mock 一栏则是对接口模拟数据的设置，具体用法在后面会详细介绍。

到这里，YApi 的简单使用介绍完毕，使用 YApi 进行基本的接口测试和维护应该问题不大了，后续介绍 YApi 的更高级用法和最佳实践。

4、Mock 接口

本节主要描述如何经过 YApi 的 Mock 服务模拟接口的数据。

首先在接口面板里选择 高级Mock 一栏，选择添加指望来定义所实现模拟的条件和数据。

 

 

 

 

添加指望时分为两部分，一块是填关于指望的基本信息，如名称，白名单IP，匹配的参数等，另一块就是指望模拟的响应数据，如响应头信息，响应体数据，甚至响应时间也能够设置。

在这里设置响应体数据时，除了使用常规的固定假数据返回，咱们可使用 Mock.js 支持的语法，让假数据随机生成，例以下方的示例模拟一个简单的响应数据： code 为 200 或者 400，message 为重复出现 1~10次的测试两次。

 

 

保存以后，咱们对接口的 Mock 地址*（预览面板中 Mock 地址连接）*进行屡次请求就随机得到如下的请求数据：{"code":200,"message":"测试测试测试","data": {}}{"code":400,"message":"测试测试测试测试测试测试","data": {}}

固然除了这样方式定义模拟数据的生成，还有许多丰富的形式，具体的数据定义语法能够参见 Mock.js 提供的官方示例：mockjs.com/examples.ht…

5、最佳实践

一、接口分级

YApi 以项目为单位进行接口的管理，基于此还提供的分类的功能，新生成的接口都有默认的分类为公共分类。

为了能更清晰，更直观有效地管理接口，咱们能够从项目的业务角度出发，在 YApi 中将业务转换为接口分类，每一个业务分类下管理各自相关的接口，而一些公共接口统一在公共分类中管理，好比下图所示，将订单业务和支付业务分别生成各自的接口分类，在该分类下都是跟自身业务紧密相关的接口。

 

 

二、环境配置

当平常开发中一个程序都会有不一样环境要求，接口请求的地址也不一样，为了便于多环境接口的切换，咱们能够在项目设置的环境配置 一项添加该项目下接口的多个环境，而且这里增长了全局 header，项目中设置全局 header 值。

 

 

 

除此以外，用户能够在每一个环境配置项中定义 global 全局变量的名称和值, 接口运行或者测试集合里面能够经过 {{ global.Name }} 来访问当前环境变量下定义的全局变量。

设置保存以后，咱们就能够在该项目下任一接口的运行面板里切换环境地址，以下

 

 

三、请求配置

YApi 支持 pre-script, 就是经过自定义 js 脚本方式改变请求的参数和返回的 Response 数据，而这个功能能够知足当咱们请求和响应的数据都是经过加密处理的使用场景。

请求配置的位置一样在项目设置里，针对项目的全部接口生效，对外提供公共变量 context 对象包含的请求和响应的全部数据 。

 

 若是咱们须要在一组接口的 URL 上增长一个公共的 token 参数，能够在 Pre-request Script 里写以下脚本：

 

 而若是咱们须要修改响应数据中某个值进行修改，能够填写以下 Pre-response Script 里写以下脚本：

 

 另外，全局变量 context 还提供的工具函数，让咱们使用：

 

 结合工具函数，咱们就能够进行接口请求时和响应时的加密处理，例如咱们须要对响应体中 data 数据进行 Base64 加密，能够定义以下脚本：

 

 

四、数据导入导出

在数据管理上，YApi 提供了简单而有效的方案来支持数据的导入和导出。

YApi 支持快速导入其余格式的接口数据，以方便快速添加接口。YApi 目前支持 Postman, Swagger, JSON 数据导入等，方便咱们进行接口数据迁移。

而当咱们须要把接口分享给非项目组内的人时，咱们可使用数据导出功能，以 HTML，Markdown 或者 JSON 的格式导出项目接口文档数据，只须要将文档文件给到他人就好了。

 

 

6、结语

本文主要记录了开源接口管理平台- YApi的基本介绍和使用。面对多人多项目的团队开发，有个统一的管理平台来进行接口管理和维护，仍是颇有必要的，也是很基础的，对项目的开发效率提升也有很大帮助，若是你有正在使用 YApi 有更好的使用姿式或者遇到什么坑，更或者在使用过其余的接口管理平台框架，也欢迎留言交流讨论。

读到这的朋友还能够私信我免费领取一份收集的一线大厂面试资料、python自动化学习资料及更多python进阶知识笔记和视频资料。