API设计-期望响应预定义
API设计的主要作用是为了满足研发人员APIfirst
的开发习惯,预先定义接口请求参数以及响应期望并生成 Mock URL,如果您仅仅需要调试接口,直接进 API调试
模块即可,无需在 API设计
模块预先定义。
a.新建期望
在同一个接口里,由于我们对不同场景下返回的数据结构期望不同,我们可以通过设置多个期望的方式,来满足这个需求。 如图,点击【新建期望】即可打开新建期望的弹窗。我们可以选择该期望的状态码、填写期望名称、选择内容格式,是否设为默认期望,最后点击保存,该期望创建成功。
b.内容格式
我们可以选择JSON、XML、 HTML、 Binary四种内容格式,其中JSON格式可以通过增加字段节点来定义数据结构、字段类型、mock值和参数描述
支持导入JSON、XML、JSON-schema、mysql ddl格式的文件,预览已编辑好的数据,支持刷新生成的数据。
JSON格式:该格式的响应内容支持json-schema、mock.js两种各自独立的数据模式,我们可以选择一种方式建立期望,数据结构设计好后,可以直接生成响应示例。
【json-schema模式】
【mock.js模式】
【预览、编辑】
c.字段类型
当我们选择json-schema格式时,可以设置每一条字段的类型,分别为 string、number、array、object、Boolean、integer、null、oneOf、anyOf、allOf
十种类型。
若需对该字段设置Mock变量,可在输入框内进行设置,支持日期变量、主键变量、WEB变量、地区变量、邮编变量、人名变量、颜色变量、文本变量
等四十余种类型字段变量
d.如何添加/删除字段
1、增加字段:默认展示root字段,当数据类型为object,点击root右侧加号,可增加兄弟节点或子节点;当数据类型为array,则自动增加一个string类型的子节点;当数据类型为string、integer、Boolean、Number、null、any,可增加兄弟节点。
2、删除字段:点击删除icon,直接删掉此字段(root根节点不能删除)
e.高级设置
我们可以对某个字段进行高级设置,定义该字段数据结构的具体细节,同时也支持以目录为作用域进行定义,如点击根目录的高级设置,则高级设置内容对该目录下所有字段有效。
当数据类型为string:
当数据类型为integer:
当数据类型为Boolean:
当数据类型为array:
当数据类型为object:
当数据类型为Number:
当数据类型为Null,则无高级设置。
当数据类型为oneOf:
当数据类型为anyOf:
当数据类型为allOf:
f.智能期望
什么是智能期望
我们可以在智能期望中填写一些触发条件,并设置当满足/不满足该触发条件后,所启用的期望。开启智能期望后,Apipost会根据已设置的触发条件,匹配旗下的参数判断规则,若满足条件,则会启用预设的期望。
如何添加智能期望
1、我们可以添加多个触发条件,每个触发条件下支持填写多个子条件。
2、填写好该触发条件下的子条件后,需要选择一个已有期望,作为满足该触发条件后所启用期望。
3、当触发条件下的所有子条件都被满足时,该触发条件才会被视为已满足。
获取自动生成的Mock url
我们可以再mock
tab页面,来获取改接口的Mock地址,使用Mock服务
本地url:是在本地进行的mock服务,只在本地可见,如需分享需要关闭防火墙。
云端url:是在Apipost云服务上进行的mock服务,可以分享给他人,当关闭url链接后,分享出去的页面将不可见。
云端Mock是默认关闭的,开启云端Mock后需要ctrl+s
保存下接口才可以生效