接口测试总结

时间 2019-11-13

标签接口测试总结繁體版

原文原文链接

摘自猴子请来得救兵

请求模型

看下图中“A”线，能够理解为接口就是一个电灯的开关，它在接口里面给你提供了一个参数，参数的值一个是“开”，一个是“关”。html

提及来，怎么才能让灯亮？一个灯头接两根线，一根线接火线，一根线接零线这时灯就亮了。反之，不接零线、火线灯就灭了。java

其实接口呢，就把这些复杂的操做简化了，让你看到的就只有一个开关，而你来操做这个开关就行了。咱们作接口测试也只须要测试这个开关就完成任务了，接口测试就是这么简单。python

当你访问“http://127.0.0.1:8080/light?opt=open”，让零线、火线连通，此时灯亮。
当你访问“http://127.0.0.1:8080/light?opt=close”，让零线、火线断开，此时灯灭。

请求结构

看到这里咱们大体就明白了接口测试是怎么一回事了。接下来须要理解一下HTTP的URL是怎么组成为一个接口的。如图：sql

一个URL就是一个接口：接口大体会分为一下几个部分：json
1. 请求协议：api
  - http — 普通的http请求
  - https — 加密的http请求，传输数据更加安全
  - ftp — 文件传输协议，主要用来传输文件
2. 请求IP：就是指提供接口的系统所部署的服务器地址浏览器
3. 请求端口：若是不填端口，默认是80，不然须要填写端口号安全
4. 接口路径：指系统提供的接口在什么位置bash
5. 接口参数：参数在接口路径后，用“?”来表示路径地址完了，剩下的都是参数了，用“&”来区分参数个数，服务器
  
  以下示例：
  
  http://127.0.0.1:8080/light?opt=open&use=yy&pwd=123456
  
  假设要操做这个灯，须要用户密码，则能够增长新的参数”use”、”pwd”，用”&”来隔开。能够看到这个示例有3个参数：
  - “opt”:”open”
  - “use”:”yy”
  - “pwd”:”123456”
6. 接口HTTP参数【url看不见等隐藏参数】
  - http请求方式
```
GET --- 经过请求URI获得资源
POST --- 用于添加新的内容
PUT --- 用于修改某个内容
DELETE --- 删除某个内容
CONNECT --- 用于代理进行传输，如使用SSL
OPTIONS --- 询问能够执行哪些方法
PATCH --- 部分文档更改
PROPFIND (wedav) --- 查看属性
PROPPATCH (wedav) --- 设置属性
MKCOL (wedav) --- 建立集合（文件夹）
COPY (wedav) --- 拷贝
MOVE (wedav) --- 移动
LOCK (wedav) --- 加锁
UNLOCK (wedav) --- 解锁
TRACE --- 用于远程诊断服务器
HEAD --- 相似于GET, 可是不返回body信息，用于检查对象是否存在，以及获得对象的元数据
```
  - http请求头
    
    请求头包含许多有关的客户端环境和请求正文的有用信息。例如，请求头能够声明浏览器所用的语言，请求正文的长度。示例：
```
Accept:image/gif.image/jpeg./ Accept-Language:zh-cn Connection:Keep-Alive Host:localhost User-Agent:Mozila/4.0(compatible:MSIE5.01:Windows NT5.0) Accept-Encoding:gzip,deflate. 
```
  - http请求体
    
    请求体就是请求等正文了，能够有不少种请求体。
    - json格式
    - xml格式
    - html格式
    - 二进制格式( 多数用于图片 )
    - 字符串格式

看到上面的请求结构，就能接口测试了，只须要修改接口的参数，就能够像功能测试同样测了。能够用功能测试设计用例的方法来设计接口测试的用例。可使用各类测试用具辅助测试，下图为“postman”测试工具。

接口的请求会发向哪里

咱们能够看看这样一个接口，用Java的Servlet怎么来实现

package com.yy.test; import net.sf.json.JSONObject; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.io.PrintWriter; // 接口的名称与路径，urlPatterns中的/light，就是说在输入地址与ip后，定义的接口名字http://127.0.0.1:8080/light @WebServlet(name = "light", urlPatterns = "/light") public class light extends HttpServlet { protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 获取opt的值 String opt = request.getParameter("opt"); // 新建返回json的对象 JSONObject json = new JSONObject(); // 判断opt有没有值 if (null != opt) { // 定义返回的请求头，类型是json，编码是utf-8 response.setContentType("application/json; charset=UTF-8"); // 定义返回的对象，用它来将json输出 PrintWriter out = response.getWriter(); // 判断opt的值是否是open if ("open".equals(opt)) { json.put("msg", "开灯啦！"); out.println(json); } // 判断opt的值是否是close else if ("close".equals(opt)) { json.put("msg", "关灯啦！"); out.println(json); } } } }

上面的代码大体作了以下几个操做：

获取opt的值
判断获取的opt的值
- 若是是”open”就返回”开灯啦！”
- 若是是”close”就返回”关灯啦！”
  
  看到上面的代码，就能发现，咱们将opt的值，传进”http://127.0.0.1:8080/light“这个接口中，当你拿到你想要的值，想作什么均可以了，对吧。我这边的代码就是简单的进行了返回，当你访问了我“开灯”的接口，我就直接告诉你“开灯了” ( 其实我什么都没作，这已经算是一个BUG了。因此测试接口要看看它到底生效了没有，也就是说，灯真的开了吗？)，咱们作接口测试，须要开发提供接口文档。最重要的有一下几点：
被测接口的地址
接口参数，以及各个参数的说明
必要的http头与http体 ( http头是能够自定义的，能够用来校验是不是本身人访问 )
接口返回什么值，以及各个返回值的说明
接口是干什么的

肯定了这些，才能作好接口测试。好的接口文档以下：

复杂一点的接口，RESTful

一个用户接口能够经过如下4种不一样方式的请求，来作不一样的事情：

获取用户信息
建立用户
修改用户
删除用户

你彻底能够像“灯”的那个例子，用GET请求来传递不一样的参数来实现，可是这样若是接口多了，就会很混乱，很难管理。

这时，咱们须要一种规则：

当用“GET”方式时，只用来获取数据，成功了返回http状态码200
当用“POST”方式时，只用来建立数据，成功了返回http状态码201
当用“PUT”方式时，只用来修改数据，成功了返回http状态码203
当用“DELETE”方式时，只用来删除数据，成功了返回http状态码204
当请求发送失败，返回http状态码400

这样子的规则，咱们称它为“RESTful”标准。

下图是RESTful的状态码返回

5. 接口测试

前面的搞清楚了，接口测试就简单了，其实就是几个步骤。

拿到接口的url地址
查看接口是用什么方式发送
添加请求头，请求体
发送查看返回结果，校验返回结果是否正确

这个是正常的一套流程，异常的状况，就不用我多说来吧。好比参数不传值呀，传的值不正确呀，明明要求用"GET"请求发送，偏要用"POST"请求发送呀。等等有不少异常状况，通常懂功能测试都能想到不少的异常状况，这里再也不举例来。

下面我以百度翻译的接口为例子：

请求地址：http://fanyi.baidu.com/v2transapi

请求方式：POST

请求参数：

from — 哪国语言

to --- 翻译成哪国语言 query --- 翻译都内容

我使用Python语言来进行接口测试，使用”requests”库来编写代码比较简答易懂，若是没有安装”requests”库，能够打开cmd，输入”pip install requests”来安装

import requests # 接口的url url = "http://fanyi.baidu.com/v2transapi" # 接口的参数 params = { "from":"en", "to":"zh", "query": "test" } # 发送接口 r = requests.request("post", url, params=params) # 打印返回结果 print(r.text) # 其实到上面就已经完了，由于百度不是我本身写的接口，为了让结果看的更加清楚一点，我取来翻译的字段 import json d = json.loads(r.text) print(d['liju_result']['tag']) 返回结果 ['试验', '测验', '考验', '化验', '考查', '受试验', '受测验', '受考验', '测得结果'] 能够试着将"query"的参数改为"student"，返回结果也随之改变 import requests url = "http://fanyi.baidu.com/v2transapi" params = { "from":"en", "to":"zh", "query": "student" # 我改了这里 } r = requests.request("post", url, params=params) import json d = json.loads(r.text) print(d['liju_result']['tag']) 返回结果 ['中学生', '学生', '大学生', '研究者', '学者']

固然，要是不懂代码，也可使用工具进行测试，只要记住填写的几个点，就能够作好接口测试，下图是使用”postman”进行测试：

输入发送方式”POST”
输入测试地址”http://fanyi.baidu.com/v2transapi“
输入下图红框参数
点击”send”，查看返回结果

接口测试就是这么简单

接口测试用例

接口测试用例的设计就没什么好讲的了，与功能测试同样设计就行了。我是用Excel来编写的，主要是为了方便管理，只要写的干净，让人看的很舒服就行了。我本身设计的用例是这样的：

一个模块对应一个Excel表
一条接口对应一张sheet表
表中一行对应一条测试用例
在开始要注明测试时须要的sql，以下图开始我会建立用户，用完了我会删除

这样的用例比较好管理，如图：