最近一直在学习和整理web开发与接口测试的相关资料。接口测试本身毫无任何难度,甚至有很多工具和类库来帮助我们进行接口测试。大多测试人员很难深入了解web接口测试的原因是对web开发不太了解,当你越了解开发就会越看得清接口是什么。当然,web开发是比较麻烦,我们很难一下子掌握。
注:不过本文并不是一个零基础的文章,需要你对 django web开发,requests接口库,unittest单元测试框架,三者有一定的了解。
之前分享过一篇django开发投票系统的例子。今天在这个例子上做一些延伸,来讲讲web接口的开发与测试。
开发投票系统接口
虽然投票系统的的功能已经开发完成,但我们并没有开发专门的接口,在当前的投票系统中,在我们调用一个get或post请求时,系统会返回整个页面,并且把测试连同页面一起返回。
例如,当我们要调用所有问题的接口时(test_get.py)
得到如下结果:
而特有的接口应该返回的是数据,而不是整个页;而数据一般格式为json格式。所以,需要对试图层(.../polls/views.py)进行改造,使其只提供接口,并单纯的返回数据。
为了节省时间,暂时先对查看所有问题、单个问题的所有选项两个功能进行接口改造,当然这里的改造也不够完整和健壮。例如单个问题的所有选项的接口,接收的参数question_id 如果为空,应该提示,参数错误。如果查询不到相关问题,应该提示,查询结果为空,如果传的类型不为数字,应该提示,类型错误。这些都是一个健壮的接口应有的处理逻辑。
再次执行test_get.py文件。
这一次得到的就是json类型的数据了。不过,返回值对中文进行了unicode的编码。这里提供个小技巧,将其转换成中文。
打开firefox浏览器的firebug工具,切换到“控制台”标签。
编写接口文档也是非常重要的一个环节,因为我们编写的接口是需要给别人调用的,那么别人如何知道我们的接口是用get还是post调用呢?参数都有哪些?当然需要参考接口文档了。
1、获取所有问题
url
http://127.0.0.1:8000/polls
请求类型
get
需要参数
无
返回格式
json
返回结果
{"1": "十一国庆七天假期做什么?",
"2": "你最想学的自动化工具是什么?"
}
错误类型
暂无(接口代码需要补充逻辑)
2、获取单个问题的所有选项
http://127.0.0.1:8000/polls/
question_id
{"1": "旅行",
"2":"看电影" ,
"3":"看书"
……
好啦!接口文档的大体结构就是上面的样子。有了这个份文档,我们接下来就很容易知道如何调用这些接口做测试了。
对于编写接口测试来说,我们会涉及到两个技术。前面也都有过简单介绍,unittest单元测试框架和request库。
接口用例测试本身的编写是简单的,我们只用调用接口,传递不同的参数。从而验证返回值是否符合预期即可。