由于一直在忙于RunnerGo设计及开发工作,公众号疏于更新。目前RunnerGo已进入内测阶段。欢迎大家内测使用。内测地址:https://demo.runnergo.cn/
目前,RunnerGo主要的功能模块有:首页、接口管理、场景管理、性能测试(计划管理、报告管理)、自动化测试(计划管理、报告管理)
本篇主要说明接口管理模块如何使用以及该模块与其他模块的关系。
首先,进入接口管理模块后,左侧栏是管理全部接口的目录区:
1. 搜索:输入接口或目录名称,支持模糊搜索、完全匹配
2. 新建接口: 点击新建接口后,会在右侧接口区tab栏新打开一个接口框,默认名称为新建接口(由于不允许接口名称重复,所以如果已经存在相同名称,需要修改接口名称后,才可对接口进行操作)
3. 新建目录:点击新建目录后,会出现下图弹窗:
可以选择父级目录(即把该目录建在哪个目录之下)。默认有一个根目录,就是我们的目录区。目录名称唯一不可重复
4. 导入接口:导入接口需要导入相应的文件,可以导入的接口来源支持:
postman、swagger、swaggerUrl、apifox、apizza、eolink、yapi、apipost等工具
5. 折叠:主要是将目录区所有的目录打开与收起
6. 回收站:删除过的接口和目录都会存放于此,可进行恢复或彻底删除操作
其次,接口管理右侧区域主要进行接口调试与保存操作
- 接口名称:可以随时修改接口名称,最大支持25个字符
- 保存按钮:可以直接保存在此时接口所在的目录或者点击后面的箭头选择要保存到的目录
3. 接口URL区域:可以选择接口方法,支持: POST、GET、PUT、PATCH、DELETE、COPY、HEAD、OPTIONS、LINK、UNLINK、PURGE等HTTP协议方法
4. 前置URL:由于我们有多个环境、多个服务,所以我们可以提前定义好不同的服务对应不同的域名(环境管理模块)再次引用或者直接输入,方便我们调试不同环境的接口。
5. url输入区:可以输入全部url或者使用前置url url的模式。默认url前缀为http://, 如图:
上方两个图接口均为:http://127.0.0.1:8080/test
6. 请求区包含:
Header:采用键值对模式,每一列代表一个请求头参数,包含是否启用该参数、参数名称、参数值(支持参数化变量操作,使用方法为:{{变量名}}, 也可使用公共函数生成相应的值,使用方法:{{__方法名()__}}, 公共方法定义及使用在公共方法模块)
自定义全局变量:
公共函数及使用方法:
Query:同Header
Body:body包含多种body格式,包括:none、form-data、x-www-from-urlencoded、raw等,raw又包括:json、xml、javascript、plain、html等。在使用时均可使用全局变量和公共函数
form-data格式下,可以上传文件, 如图:
可以在参数名中选择是否为文件类型,并在参数值里选择上传文件。
认证:目前支持私密键值对认证、Bearer auth认证、Basic auth认证、Digest auth认证
断言:支持被断言的地方分别为响应头、响应码、响应体
选择响应码后,则字段列无需填写,只需要选择条件及填写值即可,条件只可选择等于或不等于
选择响应头后,则字段列无需填写,只需选择条件及填写值即可,条件只可选择包含、不包含、为空、不为空
选择响应体后,则需填写字段、选择条件、填写值
当条件为为空和不为空时,值不用填写。
断言结果在响应去查看。
关联提取:关联提取可以提取响应码、响应头、响应体, 类型有:响应码、响应头、json(从响应体中提取)、正则(从响应体中提取),具体方法如下