接口测试实战总结

布满荆棘的人生 2023-10-08 13:50 38阅读 0赞

![在这里插入图片描述][5fb87c883155482198a70b4dca710d26.gif_pic_center]

### 序章 ###

说起接口测试，网上有很多例子，但是当初做为新手的我来说，看了不不知道他们说的什么，觉得接口测试，好高大上。认为学会了接口测试就能屌丝逆袭，走上人生巅峰，迎娶白富美。因此学了点开发知识后，发现接口测试其实都是人们玩的名词罢了。接口测试，真心很简单。它只不过是数据传递是一种表现而已。

### 请求模型 ###

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

![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16]

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

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

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

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

### 请求结构 ###

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

![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 1]

一个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格式

二进制格式( 多数用于图片 )

字符串格式

“opt”:”open”

“use”:”yy”

“pwd”:”123456”

http — 普通的http请求

https — 加密的http请求，传输数据更加安全

ftp — 文件传输协议，主要用来传输文件

请求协议：

请求IP：就是指提供接口的系统所部署的服务器地址

请求端口：如果不填端口，默认是80，否则需要填写端口号

接口路径：指系统提供的接口在什么位置

接口参数：参数在接口路径后，用“?”来表示路径地址完了，剩下的都是参数了，用“&”来区分参数个数，

如下示例：

http://127.0.0.1:8080/light?opt=open&use=yy&pwd=123456

假设要操作这个灯，需要用户密码，则可以增加新的参数”use”、”pwd”，用”&”来隔开。可以看到这个示例有3个参数：

接口HTTP参数【url看不见等隐藏参数】

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

![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 2]

![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 3]

### 接口的请求会发向哪里 ###

我们可以看看这样一个接口，用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);
                }
            }
        }
    }

上面的代码大致做了如下几个操作：

1、获取opt的值

2、判断获取的opt的值

如果是”open”就返回”开灯啦！”

如果是”close”就返回”关灯啦！”

看到上面的代码，就能发现，我们将opt的值，传进”http://127.0.0.1:8080/light“这个接口中，当你拿到你想要的值，想做什么都可以了，对吧。我这边的代码就是简单的进行了返回，当你访问了我“开灯”的接口，我就直接告诉你“开灯了” ( 其实我什么都没做，这已经算是一个BUG了。所以测试接口要看看它到底生效了没有，也就是说，灯真的开了吗？)，我们做接口测试，需要开发提供接口文档。最重要的有以下几点：

3、被测接口的地址

4、接口参数，以及各个参数的说明

5、必要的http头与http体 ( http头是可以自定义的，可以用来校验是否是自己人访问 )

6、接口返回什么值，以及各个返回值的说明

7、接口是干什么的

确定了这些，才能做好接口测试。好的接口文档如下：

![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 4]

**复杂一点的接口，RESTful**  
![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 5]

一个用户接口可以通过以下4种不同方式的请求，来做不同的事情：

1.  获取用户信息
2.  创建用户
3.  修改用户
4.  删除用户

> **你完全可以像“灯”的那个例子，用GET请求来传递不同的参数来实现，但是这样如果接口多了，就会很混乱，很难管理。**

这时，我们需要一种规则：

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

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

下图是RESTful的状态码返回

![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 6]

### 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”进行测试：

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

![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 7]

接口测试就是这么简单

### 接口测试用例 ###

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

1.  一个模块对应一个Excel表
2.  一条接口对应一张sheet表
3.  表中一行对应一条测试用例
4.  在开始要注明测试时需要的sql，如下图开始我会创建用户，用完了我会删除

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

![图片][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 8]

整个接口测试就这么多了。接口测试其实很简单，在功能测试眼里，接口测试那么高大上，其实不也过如此了。

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center]

**最后：** 可以关注公众号：伤心的辣条 ！ 进去有许多资料共享！资料都是面试时面试官必问的知识点，也包括了很多测试行业常见知识，其中包括了有基础知识、Linux必备、Shell、互联网程序原理、Mysql数据库、抓包工具专题、接口测试工具、测试进阶-Python编程、Web自动化测试、APP自动化测试、接口自动化测试、测试高级持续集成、测试架构开发测试框架、性能测试、安全测试等。

**如果我的博客对你有帮助、如果你喜欢我的博客内容，请 “点赞” “评论” “收藏” 一键三连哦！**

--------------------

### 好文推荐 ###

[转行面试，跳槽面试，软件测试人员都必须知道的这几种面试技巧！][Link 1]

[面试经：一线城市搬砖！又面软件测试岗，5000就知足了…][5000]

[面试官：工作三年，还来面初级测试？恐怕你的软件测试工程师的头衔要加双引号…][Link 2]

[什么样的人适合从事软件测试工作？][Link 3]

[那个准点下班的人，比我先升职了…][Link 4]

[测试岗反复跳槽，跳着跳着就跳没了…][Link 5]

[5fb87c883155482198a70b4dca710d26.gif_pic_center]: https://img-blog.csdnimg.cn/5fb87c883155482198a70b4dca710d26.gif#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/0061a4479def4a36af93b51165875a5d.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 1]: https://img-blog.csdnimg.cn/4bf8e8cf0c1741fb85bf9f24a9223452.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 2]: https://img-blog.csdnimg.cn/c301ad3b6ac242199706cfad0a2b6fb9.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 3]: https://img-blog.csdnimg.cn/d33ad4ed114a4c3aa16c187d57a8a382.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 4]: https://img-blog.csdnimg.cn/a08fb353a0e548f1b4e7da5cbff551b5.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 5]: https://img-blog.csdnimg.cn/579eab68e0a54092bf963e652725165c.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 6]: https://img-blog.csdnimg.cn/c6a56f9c2fe94399b0ec206bf575717b.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 7]: https://img-blog.csdnimg.cn/40e32940b0b24715a975bba0e9a775e6.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16 8]: https://img-blog.csdnimg.cn/5df286f79b32458191b9c71909cbede1.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center]: https://img-blog.csdnimg.cn/097c4afac6e9442fb23cfd91aee6ce4a.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6L2v5Lu25rWL6K-V5ZCb,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[Link 1]: https://blog.csdn.net/m0_56736369/article/details/117909132
[5000]: https://blog.csdn.net/m0_56736369/article/details/117915399
[Link 2]: https://blog.csdn.net/weixin_50829653/article/details/117422433
[Link 3]: https://blog.csdn.net/weixin_50271247/article/details/108421434
[Link 4]: https://blog.csdn.net/weixin_50829653/article/details/117856900
[Link 5]: https://blog.csdn.net/m0_56736369/article/details/117923266