关于YApi接口操作

YApi有 接口集合 和 测试集合 两个概念。

• 接口集合 将接口进行分类，使接口结构更清晰，一个接口只能属于一个集合，且不允许与其他接口重名。
• 测试集合 为了方便我们测试接口，测试集合 将若干接口组合在一起，在这里一个接口可以属于不同集合。

一、接口设置

（1）接口配置

  1.基本设置

• 接口路径：可以更改 HTTP 请求方式，并且支持 restful 动态路由，例如 /api/{id}/{name}, id和name是动态参数
• 选择分类：可以更改接口所在分类
• 状态：用于标识接口是否开发完成。
• Tag：用于标识接口tag信息（v1.3.23+）,在接口list页可以根据tag过滤接口

  2.请求参数设置

• Query参数： 接口 url 的查询字符串，点击『添加Query参数』按钮来添加参数，可以通过拖动来交换参数位置
• 请求Body：http 请求 body 部分，如果http请求方式是 post, put 等请求方式时会有 req_body 部分。req_body_type 形式有4种，分别是 form, json, file 和 raw 。
• Headers: http 请求头字段，在 req_body 形式是 form 格式下会在 header 中自动生成 'Content-Type application/x-www-form-urlencoded'，其他3种格式也会自动生成不同 header

  3.返回数据设置

• 返回数据分为 json & raw 两种形式。
• 选择json-schema 则进入了 json 结构可视化编辑器形式, 数据以 json schema 格式解析

  （2）接口运行

  接口运行功能，是用来测试真实接口的，类似『Postman』的功能。

  点击运行 tab ,可进入到接口测试页面，首先安装『chrome crossRequest』扩展，才可正常使用此功能。

  点击保存按钮可把当前接口保存到测试集，方便下次调试。

  安装完插件记得刷新页面

  

  接口返回数据验证

  版本 v1.3.22 新增返回数据验证功能， 如果接口的返回数据格式为json schema 在接口运行时会对接口返回数据和定义数据格式进行校验