接口测试的工具有很多,之前在另外一篇文章中写过用 Postman 做接口测试的 https://www.jianshu.com/p/fdfbf790927a,这次我们来学习用另外一个工具 JMeter 来做一个简单的接口测试。
1、获取 API 信息
API的方法:GET
API的URL:https://api.seniverse.com/v3/weather/now.json
API的参数:
-
请求参数:
参数名 参数类型 参数意义 是否必选 key string 你的API密钥 (需要自主到心知天气平台获取) true location string 查询的地理位置 true language string 结果表示的语言 false,默认简体中文 unit string 结果表示的单位(华氏度,摄氏度) false,默认摄氏度 location 参数值范围:
代理位置有世界各地的,可以参考一份数据文档,链接:https://pan.baidu.com/s/1_LTRGVI799L-sfZyWbbIPA 密码:gk3t
language 参数值范围:
-
zh-Hans
简体中文 -
zh-Hant
繁体中文 -
en
英文 -
ja
日语 -
de
德语 -
fr
法语 -
es
西班牙语 -
pt
葡萄牙语 -
hi
印地语(印度官方语言之一) -
id
印度尼西亚语 -
ru
俄语 -
th
泰语 -
ar
阿拉伯语 -
默认值:
zh-Hans
unit 参数值范围:
当unit为c时
返回值 单位 温度 c(摄氏度) 风速 km/h(千米每小时) 能见度 km(千米) 气压 mb(百帕) 当unit为f时
返回值 单位 温度 f(华氏度) 风速 mph(英里每小时) 能见度 mi(英里) 气压 in(英寸) -
-
响应参数:
参数名 参数类型 参数意义 location 对象:包括id, name, country, path,timezone, timezone_offset now 对象:包括 text,code, temperature last_update 日期 示例:
{ "results": [ { "location": { "id": "WS10730EM8EV", "name": "深圳", "country": "CN", "path": "深圳,深圳,广东,中国", "timezone": "Asia/Shanghai", "timezone_offset": "+08:00" }, "now": { "text": "多云", "code": "4", "temperature": "29" }, "last_update": "2018-09-04T19:20:00+08:00" } ] }
2、编写用例脚本
首先在 JMeter 的线程组下创建一个 HTTP 请求测试脚本,把 API 的信息填写完整。
3、运行用例脚本
然后在线程组下添加监听器--察看结果树,运行用例脚本。
从上面的响应数据可以看到服务器成功返回了相对应的天气结果。
4、用例断言
返回响应数据后,接着对用例编写一个断言判断测试是否通过。下面我们以断言城市名称 name 参数为例对这个测试用例添加一个断言。
4.1 编写断言
断言的方式有很多,平时测试可以根据自己的需要选择不同的断言方式。
这里我们选择 JSON Assertion 的方式,在请求下添加一个 JSON Assertion 断言。
这里有几个配置项要设置一下:
Assert JSON Path exists:要断言的 JSON 元素路径。其中请求响应数据的 JSON 对象换成了别名$
, 路径的写法有2种,一种是$.results[0].location.name
,另外一种是$['results'][0]['location']['name']
。
Additionally assert value:如果想让断言具有某些值,勾选复选框,这里我们勾选上。
Expected Value:断言的值 。这里写上期望的 name 值:深圳。
最后,在脚本下添加一个监听器--断言结果来监听断言的结果情况。
4.2 查看断言结果
添加断言后,再次运行一次用例脚本。
从上图可以看出断言通过了。
为了看断言失败的效果,故意改错请求中的 location 参数值。
再发送一次请求。
这次可以看到用例断言失败了。
以上就是一个用 JMeter 工具做接口测试的简单例子,希望对初学者有用。
网友评论