YApi-高效、易用、功能强大的可视化接口管理平台—

YApi 项目管理

- 新建项目
- 修改项目图标
- 项目迁移
- 项目拷贝
- 删除项目
- 配置环境
- 请求配置
- - 请求参数示例
  - 返回数据示例
  - storage
  - 工具函数
  - 异步处理（v1.3.13+支持）
- token
- 全局mock

新建项目

点击右上角的 + 新建项目，进入新建项目页面：
完善项目信息，指定项目所属分组，点击【+创建项目】：

注：权限公开私有可以在项目创建之后进行设置。
查看创建好的项目：
在项目页点击上方的 设置 Tab 进入项目设置面板，这个面板涵盖了项目的所有配置：

修改项目图标

在【项目配置】页点击项目图标，可以修改图标及背景色：

项目迁移

YApi 中支持项目迁移到不同的分组中：

迁移权限：只有管理员和该项目的 owner 有权限对位置进行修改。项目 owner 主要有创建该项目的人、项目中的组长、创建分组的人、分组中的组长。

注：owner 权限判断的优先级是项目权限 > 分组权限

项目拷贝

该功能在 v1.3.12 版本上线，项目克隆功能可复制项目全部接口到一个新项目，如下图所示，点击红色框里面的 icon 使用。

注：如果你在该分组下有新建项目的权限，那你也同时拥有复制项目的权限
点击下图左上角的复制按钮，在弹窗中写入复制项目名称点击确定就可以完成项目复制：

注：YApi 支持项目复制功能，但是无法复制项目中的测试集合 list。

删除项目

点击下方的删除按钮：

输入项目名称进行删除：

配置环境

环境配置 一项可以添加该项目下接口的实际环境，供接口测试使用，这里增加了全局 header，可以在项目中设置全局 header 值。在接口运行页面的选择环境 select 中也增加环境配置弹层。

v1.3.21 新增全局变量，用户可以在环境列表中定义全局变量的名称和值, 接口运行或者测试集合里面可以通过 {{ global.token }} 来访问当前环境变量下定义的全局变量：

请求配置

pre-script，通过自定义 js 脚本方式修改请求的参数和返回的 response 数据。

请求参数示例

以 jquery ajax 为例，假设当前的请求参数是：

{url: '/api/user?id=1',method: 'POST',headers: {xxx: 'xxx'},data: {type: 1}
}

那么公共变量 context 包含以下属性：

context = {pathname: '/api/user',query: {id: 1},requestHeader: {xxx: 'xxx'},method: 'POST',requestBody: {type:1}
}

假设我们需要在一组接口的 url 上增加一个公共的 token 参数，可以写如下自定义脚本：

context.query.token = context.utils.md5(context.pathname + 'salt');

返回数据示例

在上面的示例请求完成后，假设返回 responseData={a:1},公共变量 context 包含以下属性：

context = {pathname: '/api/user',query: {id: 1},requestHeader: {xxx: 'xxx'},method: 'POST',requestBody: {type:1},responseData: {a:1},responseHeader: {content-type: 'application/json'...}
}

假设我们需要修改响应数据 responseData a 的值为 2，可以填写如下自定义脚本：

context.responseData.a = 2;

（v1.3.16+新增）context.href 和 context.hostname
（v1.3.17+新增）context.caseId 测试用例的唯一 key 值

storage

storage.setItem 兼容浏览器和服务端，并且是持久化数据存储，不会丢失，用法类似于 localStorage。 storage 一共两个 api，分别是 setItem 和 getItem

storage.setItem('xxx', 'token-----xxxxx')
context.query.token = storage.getItem('xxx')

工具函数

context.utils = {_         //underscore 函数,详细 API 查看官网 http://underscorejs.org/CryptoJS  // crypto-js（v1.3.21+新增）, 详细用法看 https://github.com/brix/crypto-jsbase64    //转换字符串为 base64 编码md5       //转换字符串为 md5 编码sha1      //转换字符串为 sha1 编码sha224    //转换字符串为 sha224 编码sha256    //转换字符串为 sha256 编码sha384    //转换字符串为 sha384 编码sha512    //转换字符串为 sha512 编码unbase64  //转换 base64 编码为字符串  axios     // axios 库，可用于 api 请求，官网 https://github.com/axios/axios
}

CryptoJS 具体用法

var data = [{ id: 1 }, { id: 2 }];// Encrypt
var ciphertext = context.utils.CryptoJS.AES.encrypt(JSON.stringify(data), 'secret key 123');// Decrypt
var bytes = context.utils.CryptoJS.AES.decrypt(ciphertext.toString(), 'secret key 123');
var decryptedData = JSON.parse(bytes.toString(CryptoJS.enc.Utf8));console.log('decryptedData', decryptedData);

异步处理（v1.3.13+支持）

处理请求参数，或返回数据，可能还会涉及到异步处理，比如 ajax 请求，YApi 在 v1.3.13 版本支持了异步处理。

context.promise = new Promise(function(resolve) {var api = context.utils.axios.get('http://yapi.local.qunar.com:3000/api/user/status');api.then(function(result) {//...console.log(result.data);resolve();});
});

promise 还可以来设置接口延迟

context.promise = new Promise(function(resolve) {setTimeout(function() {console.log('delay 1000ms');resolve('ok');}, 1000);
});

使用方法就是在 context 里面添加 promise 参数,并且返回一个 Promise，不熟悉 Promise 的童鞋可以查下相关用法，ajax 请求可以使用 context.utils.axios 库。

处理完成后，不要忘记 resolve()，不然会一直处于挂起状态

token

每个项目都有唯一的标识 token，用户可以使用这个 token 值来请求 openapi。

openapi 文档地址

全局mock

v1.3.21 新增全局 mock 设置，方便用户在项目层面上全局设置公共的mock数据，具体 mock 脚本详细使用方法详见自定义 Mock 脚本

Mock 优先级说明

请求 Mock 数据时，规则匹配优先级：Mock 期望 > 自定义 Mock 脚本 > 项目全局 mock 脚本 > 普通 Mock。

如果前面匹配到 Mock 数据，后面 Mock 则不返回。