项目操作

    • tag 信息：可自定义tag名称和tag描述，tag信息可用在接口tag标识中;
    • 开启json5：开启后允许接口请求body 和返回值中写 json 字段。yapi建议用户关闭 json5， 因为json-schema 格式可以进行接口格式校验。

    新建项目

    点击右上角的 新建项目，进入新建项目页面。

    在新建项目页，填写项目信息：

    项目操作 - 图3

    修改项目

    在项目页点击上方的 设置 Tab 进入项目设置面板，这个面板涵盖了项目的所有配置。

    这里比新建项目页面新增的功能如下：

    点击项目图标，可以修改图标及背景色：

    项目操作 - 图5

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

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

    Tips: owner 权限判断的优先级是 项目权限 > 分组权限

    项目拷贝

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

    操作： 点击下图左上角的复制按钮，在弹窗中写入复制项目名称点击确定就可以完成项目复制

    项目操作 - 图7

    删除项目

    点击下方的删除按钮，输入项目名称进行删除。

    删除项目是高风险操作，因此 YApi 对这个操作进行了特别的约束。

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

    项目操作 - 图9

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

    请求配置

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

    请求参数示例

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

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

    1. context = {
    2.   pathname: '/api/user',
    3.   query: {
    4.     id: 1
    5.   },
    6.   requestHeader: {
    7.     xxx: 'xxx'
    8.   },
    9.   method: 'POST',
    10.   requestBody: {
    12.   }
    13. }
    1. context.query.token = context.utils.md5(context.pathname + 'salt');

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

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

      storage

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

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

      CryptoJS 具体用法

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

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

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

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

      promise 还可以来设置接口延迟

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

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

      token

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

      openapi 文档地址

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

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