看完这篇博客，我保证你肯定会做接口测试了。
最近给公司的新员工培训web api接口测试，发现这一块的内部需求还比较大，不仅仅是新员工，包括一些经常写接口测试老员工，对接口也是似懂非懂的，所以我绝对有必要写一篇博客来普及下。
在我们公司内部，一般使用ruby或者python语言来做接口测试，这篇文件主要是讲解使用python语言来做接口测试。
如果要做接口测试，其实只要会抓包，会组装http请求头和请求体，会检查http响应头和响应体，就可以可以，所以我们需要需要掌握下面这些知识！！！另外还需要掌握一些常用的测试框架，比如unittest和pytest等
1、python语言requests库
2、http协议基本知识，包括请求头，响应头、请求体、响应体
3、session-cookie（如果大家对session和cookies不熟悉，可以看我之前写 的博客）
https://www.cnblogs.com/bainianminguo/p/9147418.html
https://www.cnblogs.com/bainianminguo/p/8850043.html
4、fiddler抓包工具
5、测试框架，这里不会讲，大家有兴趣可以看下我之前写的博客，介绍unittest测试框架
https://www.cnblogs.com/bainianminguo/p/11706244.html
https://www.cnblogs.com/bainianminguo/p/11616526.html
下面进入正题，听我娓娓道来。
一、http协议
1、简介
web api接口大都是基于http协议的，所以要进行接口测试，首先要了解HTTP协议的基础知识。
HTTP协议全称是超文本传输协议。由于HTTP最初是用来在浏览器和网站服务器之间传输超文本的（网页，视频，图片等）信息的。由于HTTP简洁易用，后来，不仅仅是浏览器和服务器之间使用它，服务器和服务器之间，手机app和服务器之间，都广泛的采用，成了一个软件系统间通信的首选协议之一。
HTTP协议有好几个版本，包括0.9、1.0、1.1、1.2，当前最广泛使用的是HTTP/1.1版本
HTTP协议最大的特点是通讯双方分为客户端和服务端。
由于目前HTTP是基于TCP协议，所以要进行通讯，客户端必须先河服务端创建TCP连接。而且HTTP双方的信息交互，必须要这样一种形式
a、客户端先发送http请求（request）给服务器
b、然后服务器发送http响应（response）给客户端
c、特别要注意，在http协议中，服务端是不能主动发消息给客户端的
流程图如下
http1.1版本先创建TCP连接，然后在这个连接内可以进行多次交互信息，这里注意，是客户端主动给服务端发请求的
二、http请求
下面是http的get请求和http的post请求的示例
GET /mgr/login HTTP/1.1 Host: 192.168.3.1 User-Agent:Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36 Accept-Language:zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4 Accept-Encoding:gzip, deflate, sdch
POST /api/test HTTP/1.1
Host:192.168.3.1
Origin:http://192.168.3.1
Referer:http://192.168.3.1/html/index.html
User-Agent:Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36
Content-Type:application/json;charset=UTF-8
Content-Length:214
Accept-Language:zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4
Accept-Encoding:gzip, deflate
{"csrf":{"csrf_param":"35iUJau6mdmmJeIg0N8W80OmoMK8A2Kr","csrf_token":"KfKSfpH0hnsSc0uQyX6ZUB8i8KRFSZ0C"},"data":{"username":"admin","firstnonce":"c7eb46830667147fc62838e7ba9a0c09187d28bafa45b133897efa9d4e46a880"}}
一个http请求消息由下面几个部分组成
a、请求行 request line
是http的第一行的内容。表示要操作什么资源，使用的http协议的版本是什么，里面包含了三部分消息。请求的方法、操作资源的地址、协议的版本号
GET https://securepubads.g.doubleclick.net/pagead/adview?ai=C3a-FX0L-XZ7nH8Hn2gT1vpKQBofP2MxZl96OgJYKsfz66E0QASC3tpYCYJ0ByAEBqQIDDuevOSiDPuACAKgDAcgDCqoE5AFP0PxttPf1dpFDQI04YpU7K4Qhq0WGx-H6233i9kddKMRmZ8rfGeWBQrr479rzo9D8pahF4GnAvGpwUHZntCL7HcXpQi_xqWQt3alVu7iKmqOQ2r6wzaMJli0vfW_rWq9l6hMmC3THotaE3aaCu8-yQ18_cRaCfgKTCRRx0Eze2gWYfJic33lRDI5NHSVfSlXDsc3SItNtoxG4tZhzRdw3omfX6oWwyvxUVboGzJwd8Rfij2Abfe4gFMviIlfhgVkNNRVv3U-Zhi6Xu5dTGhbV952-dpPUto1PgnRuTQpfsnvJ9UbABKmyupce4AQBkgUECAQYAZIFBAgFGASAB9GIrh6oB47OG6gH1ckbqAeT2BuoB7oGqAfy2RuoB6a-G6gH7NUb2AcB8gcEEPCNAtIIBwiAYRABGB2ACgHICwHYEwKIFAE&sigh=RmPL7gCMtsg&tpd=AGWhJmu9ZlDGyMSGWoSTQKbLoOl12TOWdSdugT6uZH2DizpViw HTTP/1.1
b、请求方法
Get请求
从服务器上获取资源信息，这是一种最常见的请求
比如要从服务器获取网页资源，获取图片资源，获取用户信息数据等
Post请求
添加资源信息到服务器进行处理，例如要添加用户信息，上传图片数据到服务器等，具体的数据信息，通常在HTTP请求的消息体中，这个后面会讲
Put请求
请求服务器更新资源信息
比如要更新用户、姓名地址等等
具体的更新的数据信息，通常在HTTP的消息体中，后面会讲
Delete请求
请求服务器删除资源信息
比如要删除某个用户，某个资源等等
HTT片协议还有许多其他的方法，比如PATCH,HEAD等，不是特别常用，暂且不讲
c、资源地址
d、请求头
这里业务大家有个疑问，我的http请求是建立在tcp连接的基础上的，为什么这里还要传递一个host呢？因为我们知道ip地址了，但是这个ip地址上可能有多个网站，所以这里要指定我们要访问的具体是哪个网站
请求体的http请求下面的内容，里面存放一些信息。
比如请求发送的服务端的域名是什么，希望接受的响应消息使用语言，请求消息体的长度等等；
通常请求头有好多个，一个请求头占据一行
单个请求头的格式是：名字：值
e、请求体
请求的url，请求头中可存放一些数据信息，但是有些数据信息，往往需求存放在消息体中国；特别是post，put的请求，添加，修改的数据信息通常都是存放在请求消息体中的；
如果HTTP请求有消息体，协议规定，需要在消息头和消息体之间插入一个空行，隔开他们；
请求消息体中保存了要提交个服务端的数据信息
比如：客户端要上传一个文件给服务器，就可以通过http请求发送文件数据给服务端；
文件的数据就应该在请求的消息体中
请求的消息体通常是某种格式的字符串，常见的有三种，但是最常用的还是json格式
Json
Xml
www-form-urlencoded
后面会有详细的描述
request payload就是一个请求体，下面这个格式就是Json格式的消息体
请求体中不仅仅可以存放字符串，还可以放二进制信息，比如以下视频、文本之类的，用于我们上传文件的场景，不过通常接口测试不会涉及二进制信息，都是字符串信息，后面我会专门写一篇博客来介绍如何上传文件
2、http响应
响应的消息我们重点关注状态码
a、2xx
通常表示请求消息没有问题，而且服务器也正确处理了
b、3xx
这是重定向响应，常见的是是301、302，表示客户端的这个请求的url地址已经改变了，需要客户端重启发起一个请求到另外一个url
c、400
表示客户端请求不符合接口要求，比如格式完全错误
d、401
表示客户端需要先认证才能发送请求
e、403
表示客户端美誉哦权限要求服务器处理这样的请求，比如普通用户的没有管理员的权限
f、404
表示客户端方法的url不存在
g、5xx
表示服务端在处理请求中，发送了未知错误，通常是服务端的代码设计的问题，或者服务端系统出了故障了
有了以上的基础，我们就可以做web的接口测试了
二、接口测试
1、什么是接口测试
我们通常说的接口测试，其实就是对软件系统的消息交互接口的参数，消息交互接口是软件系统和其他软件系统交互的那部分，比如，你正在用浏览器使用一个网站，浏览器和后端服务器之间就是消息交互的；在比如，你手机上使用美团订餐，美团app和美团服务器之间，也是消息交互的，当你提交订单，使用功能微信支付的时候，美团服务器和微信服务器之间也是通过消息交互的
接口测试就是
依据接口规范，写出测试用例
使用软件工具，直接通过消息接口对被测系统进行消息收发
验证被测系统行为是否正确
目前软件系统之间的消息接口大部分是基于HTTP协议收发的
HTTP协议的特点是，客户端发出一个HTTP请求给服务端，服务端就返回一个HTTP相应，好像API程序调用；
所有接口测试通常又被称为API接口测试或者WEB API接口测试
API接口传递数据信息是通过HTTP协议进行收发的，网站获取网页，图片，css等资源，也是通过HTTP协议进行收发的
那么这两者有什么区别呢？为什么获取网页，图片这些HTTP消息不叫做API接口消息呢？
网页，图片，css这些资源都是静态资源，就是一个一个文件存储在服务器中，获取这些消息，服务端直接读取文件，返回给客户端即可，无需特别的数据处理
而API接口请求消息，通常都需要服务端程序进行一番处理，比如对请求的权限检查，从数据库中读出数据，进行消息过滤和格式转换，最后在HTTP响应中返回给客户端
接口测试需要工具和被测系统之间进行消息的收发，这个工具可以是别人开发的，也可以自己开发，基于HTTP的接口测试工具有Postman，Jmeter等
2、fiddler工具
这里我们使用python语言中的requests库和fiddler抓包工具
Fiddler：代理式抓包
大家一定会反问，我的浏览器就是可以抓包了，为什么还要安装fiddler，多此一举？
其实不然，因为我们是用python的requests库去做接口测试，浏览器是抓不到我们发的请求的，所以需要安装fiddler来抓包，确保我们发送的http请求是正确的
fiddler启动后，会启动一个代理服务器，监听在8888端口上，http客户端需要设置fiddler作为代理，把http请求消息发送给fiddler，fiddler转发http消息给服务端，服务端返回消息也是先返回给fiddler。再由fidddler转发给客户端
如下图所示
fiddler安装后，会默认配置操作系统级别的代理，可以通过下面的方式查看
安装fiddler需要配置一个过滤项，因为默认fiddler是作为一个系统代理，所以fiddler抓到包会很多，所以需要配置一个过滤项
同样，这里的配置是支持通配符的
抓包
查看原始的请求消息
我们可以在python代码里配置代理，然后通过fiddler抓包来判断我们发的包是否准确，这里需要配置http和https协议的代理
import requests
proxies = {
"http":"127.0.0.1:8888",
"http1": "127.0.0.1:8888"
}
res = requests.get(
url = "htt://www.baidu.com",
proxies = proxies
)
我们可以通过fiddler进行抓包
fiddler如果 要配置手机抓包代理，需要保证安装fiddler和手机在同一个局域网中
在手机的无线网络处配置代理，代理指向运行fiddler的电脑的ip即可，端口是8888
3、requests库的请求
a、构建请求的url参数，这个一般在get请求使用较多
什么是url参数
比如
https://www.baidu.com/s?wd=iphone&res_spt=1
问号后面的部分wd=iphone&res_spt=1就是url参数，每个参数之间就用&隔开的。
上面的例子中有两个参数wd和res_spt，他们的值分别iphone和1
url参数参数的格式，有个术语叫urlencoded格式
使用requests发送HTTP请求，url里面的参数，通常可以直接在url里面，比如
但是有的时候，我们的url中参数里面有特殊字符，比如参数中的值包含了一个&这个符号或者参数很多的话，我们可以采用下面的方法，构建一个字典，然后把这个字典传递给params参数
也可以用下面的方式传递url参数
res = requests.get(
url = "http://www.baidu.com/",
params = {
"wd":"iphone",
"res_spt":"1"
},
proxies = proxies
)
b、构建请求消息头
有的时候，我们需要自定义一些http的消息头
每个消息头也就是一种键值对的格式存放数据，在requests，只需要把抓包中的请求头信息放在一个字典中，然后传递headers即可
res = requests.get(
url = "http://www.baidu.com/",
headers = {
"Host": "192.168.3.1",
"User-Agent":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36",
"Accept-Language":"zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4",
"Accept-Encoding":"gzip, deflate, sdch"
},
params = {
"wd":"iphone",
"res_spt":"1"
},
proxies = proxies
)
c、构建请求的消息体
当我们进行api接口测试的时候，根据接口规范，构建的http请求，通常需要构建消息体
http的消息体就是一串字节，里面包含了一些信息，这些信息可能是文本，比如html网页作为消息体，也可能是视频，音频信息
消息体可能很短，只有一个字节，比如字符a，也可能很长，有几百个字节
最常见的消息体格式当然是表示网页内容的html
当时在web api接口测试中，常见的HTTP消息体的格式有三种，urlencoded，json，xml
注意：消息体采用什么格式，是由开发人员设计决定的，开发人员也可以自定义格式，但是我们通常不会自定义的
xml格式
前面时候了，消息体就是存放信息的地方，信息的格式完全取决于设计者的需求，如果设计者决定使用xml格式传输一段信息，用requests库，只需要这样就可以了
playload = """
<?xml version="1.0"?>
<methodCall>
<methodName>examples.getStateName</methodName>
<params>
<param>
<value><i4>41</i4></value>
</param>
</params>
</methodCall>"""
res2 = requests.post(
url = "http://www.baidu.com/",
headers = {
"Host": "192.168.3.1",
"User-Agent":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36",
"Accept-Language":"zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4",
"Accept-Encoding":"gzip, deflate, sdch",
"Content-Type": "text/xml"
},
data=playload.encode("utf-8"),
proxies = proxies
)
由于消息体都是字节串，我们直接把字符串使用utf-8解码，然后传递给data参数即可，这里需要注意，需要设置Content-type=text/xml
使用data参数，存储消息体的数据，如果传递的是一个字符串，在http请求中，需要编码为字节码，默认的编码格式latin-1，这种编码格式是不支持中文的；通常我们使用utf-8的编码格式
通过fiddler抓包
查看请求的原始信息
Urlencoded格式
这种格式的消息体就是一个key-value键值对的格式存放数据，如下所示
key1=value1&key2=value2
Requests发送这样的数据，当然可以直接把这种格式的字符串传入到data参数里；但是这样写的话，如果参数本身就有特殊字符，比如等号，就会有歧义
我们还有更方便的方法，只需要将这些键值对的数据构建一个字典，如下
playload = {
"key1":"value1",
"key2":"value2"
}
res2 = requests.post(
url = "http://www.example.com",
headers = {
"User-Agent":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36",
"Accept-Language":"zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4",
"Accept-Encoding":"gzip, deflate, sdch",
"Content-Type": "application/x-www-form-urlencoded;charset=utf-8"
},
data=playload,
proxies = proxies
)
这里需要注意下面2个地方
通过fiddler抓包
先看请求头
这里明显可以看到，请求头和请求体中间有一个空行
看下请求体中的数据
Json格式的消息体
Json字符串一律用双引号，不能用单引号
Json字符串最后一个元素的后面不能加逗号
其实我们要把数据放到消息体中，最终的数据都是字节串，也就是把str.encode()
json格式当前被web api接口广泛采用
json是一种表示数据的语法格式，他和python表示数据的语法非常像
json格式有两种方式构建消息体
方式1
playload = {"title": "test", "sub": [1, 2, 3]}
res2 = requests.post(
url = "http://www.example.com",
headers = {
"User-Agent":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36",
"Accept-Language":"zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4",
"Accept-Encoding":"gzip, deflate, sdch",
"Content-Type": "application/json;charset=utf-8"
},
json=playload,
proxies = proxies
)
注意下面这里
方式2
import json
playload = {"title": "test", "sub": [1, 2, 3]}
res3 = requests.post(
url = "http://www.example.com",
headers = {
"User-Agent":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36",
"Accept-Language":"zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4",
"Accept-Encoding":"gzip, deflate, sdch",
"Content-Type": "application/json;charset=utf-8"
},
data = json.dumps(playload,ensure_ascii=False).encode("utf-8"),
proxies = proxies
)
注意下面这里
4、requests库的响应
a、检查HTTP响应状态码
要检查HTTP响应的状态码，直接通过response对象的status_code属性获取
import json
playload = {"title": "test", "sub": [1, 2, 3]}
res3 = requests.post(
url = "http://www.example.com",
headers = {
"User-Agent":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36",
"Accept-Language":"zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4",
"Accept-Encoding":"gzip, deflate, sdch",
"Content-Type": "application/json;charset=utf-8"
},
data = json.dumps(playload,ensure_ascii=False).encode("utf-8"),
proxies = proxies
)
print(res3.status_code)
运行结果发现返回的结果状态码就是200
如果故意写一个不存在的地址
import requests
proxies = {
"http":"127.0.0.1:8888",
"http1": "127.0.0.1:8888"
}
res = requests.get(
url = "http://192.168.3.1/html/index4.html",
proxies = proxies
)
print(res.status_code)
运行结果发现返回的状态码就是404
b、检查响应的消息头
要检查HTTP响应的消息头，直接通过response对象的header属性获取
import json
import requests
import pprint
playload = {"title": "test", "sub": [1, 2, 3]}
proxies = {
"http":"127.0.0.1:8888",
"http1": "127.0.0.1:8888"
}
res3 = requests.post(
url = "http://www.example.com",
headers = {
"User-Agent":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36",
"Accept-Language":"zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4",
"Accept-Encoding":"gzip, deflate, sdch",
"Content-Type": "application/json;charset=utf-8"
},
data = json.dumps(playload,ensure_ascii=False).encode("utf-8"),
proxies = proxies
)
print(pprint.pprint(dict(res3.headers)))
结果如下
c、检查响应消息体的文本内容
前面我们已经说过，要获取响应的消息体的文本内容，直接通过response对象的text属性即可获取
import requests
import pprint
#
proxies = {
"http":"127.0.0.1:8888",
"http1": "127.0.0.1:8888"
}
#
res = requests.get(
url = "http://mirrors.sohu.com",
proxies = proxies
)
#
#
# print(res.text)
print(pprint.pprint(dict(res.headers)))
print(res.encoding)
响应体其实也是字节串，但是我们调用text方法没有设置解码格式，他是怎么解码？他是根据响应头的contend-type来决定解码格式，有的时候会指定，但是大部分不会指定
我们
我们可以看到我们打印的解码格式，和content-Type中是一样的
如果有的时候中文解码出来是乱码，我们可以手动指定解码格式
如果我们想打印响应体的字节串可以使用content方法
5、session
a、原理
我们来思考一个问题，一个网站，比如一个购物网站，服务成千上万的的客户，那么多客户同时访问网站，挑选物品，购物估算，都是通过hTTP请求来访问网站的，这个网站的服务端怎么区分每个HTTP请求呢？网站的服务端是怎么实现的？
一种最常见的方式就是：通过Session+cookies机制
session翻译成中文就是会话的意思
session大体的原理如下面2个图
http协议规定了，网站的服务端放HTTP响应的消息头set-Cookies里面的数据，叫做cookies数据，浏览器客户端必须要保存下来。而且后续访问该网站，必须在http的请求头Cookies中携带保存的所有的cookie数据
用户使用客户端登陆服务端，服务端进行验证，比如验证用户名和密码，验证通过后，服务端系统高就会为这次登陆创建一个seesion，同时创建一个唯一的sessionID。标志这个session。然后，服务端通过HTTP响应，把sessionID告诉客户端，客户端在后面的HTTP请求的消息头，都要包含这个sessionID。这样服务端就会知道，这个供求对应哪个session，从而知道这次的请求对应哪个用户；
从上图可以看出，服务端是通过HTTP的响应头set-cookies把产生的sessionID告诉客户端。
客户端的后续请求，是通过HTTP请求的请求头Cookies告诉服务端他所持有的sessionid的
b、request库支持session的
request处理session-cookies
我们在python代码中如果接收到服务器的http响应，其他set-cookies的数据怎么保存呢？后续怎么样把请求消息头中cookies中呢？
前面学过HTTP响应中如何获取响应头，构建请求怎么设置请求头，完全可以处理。
但是requests库为我们这个处理
requests库给我们提供了一个session类。通过这个类，无需我们操心cookies和session这个事情。reqeusts库会自动帮我们保存服务端发挥的cookies数据，HTTP请求自动在消息头中放入cookies数据
如下所示
import requests
import json
session = requests.session()
playload = {"title": "test", "sub": [1, 2, 3]}
proxies = {
"http":"127.0.0.1:8888",
"http1": "127.0.0.1:8888"
}
res = session.post(
url = "http://www.example.com",
headers = {
"User-Agent":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36",
"Accept-Language":"zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4",
"Accept-Encoding":"gzip, deflate, sdch",
"Content-Type": "application/json;charset=utf-8"
},
data = json.dumps(playload,ensure_ascii=False).encode("utf-8"),
proxies = proxies
)
res = session.get()
- 接口测试方法及测试数据准备分享讨论 [ 光影人像 东海陈光剑 的博客 ]
- WebService系列博客{四}[基于接口的发布服务和测试客户端]
- 日常接口测试的三轮测试 [ 光影人像 东海陈光剑 的博客 ]
- 接口测试的测试用例类型 [ 光影人像 东海陈光剑 的博客 ]
- 接口测试在淘宝的应用 [ 光影人像 东海陈光剑 的博客 ]
- 测试Windows Live Writer 发布 csdn 博客
- 利用在线HTTP接口测试工具ApiPost，模拟移动端请求API接口
- 接口测试从零开始2------接口测试的全过程2
- 分布式的几件小事（七）分布式系统接口的幂等性如何保证
- 基于Jmeter+Maven+Jenkins持续集成接口测试框架
- 使用ApiPost测试接口时需要先登录怎么办？利用Cookie模拟登陆！
- Android SDK Web SDK 接口测试总结
- 接口测试用例设计
- 测试我的第一篇博客
- 新开博客测试一下
- 初探接口测试框架--python系列2
- Postman Json测试接口
- 搭建持续集成接口测试平台（Jmeter+Jenkins+Ant）
- <h1>测试博客</h1><script type="text/javascript">alert(456);</script>
- Asp.net 面向接口可扩展框架之使用“类型转化基础服务”测试四种Mapper(AutoMapper、EmitMapper、NLiteMapper及TinyMapper)