自动化接口实战（一）

说明：该篇博客是博主一字一码编写的，实属不易，请尊重原创，谢谢大家！

目录

一丶什么是接口测试？

1.概述

2.接口分类

二丶RESTful

1.概述

2.RESTful架构风格的特点

三丶HTTP协议

1.URL篇

2.请求篇

3.响应篇

4.消息报头

5.请求正文

6.响应实体（正文）

四丶如何开展接口测试

1.跟开发要接口文档

2.构造测试数据，编写测试用例

五丶正式开展测试

1.WebTours环境搭建

2.get请求接口

3.post请求接口

4.参数关联接口

5.使用unitest进行接口测试

6.数据和代码分离

---

一丶什么是接口测试？

1.概述

接口测试是测试系统组件间接口的一种测试，接口测试主要用于检测外部系统与系统之间以及内部各个子系统之间的交互点，测试的重点是要检查数据的交换、传递、和控制管理过程，以及系统间的相互逻辑依赖关系等

目前比较流行的接口测试就是软件接口的测试，那么该接口测试的原理是通过测试程序模拟客户端向服务器发送请求，服务器接收请求后做出相应的处理并将响应信息发送给客户端，客户端接收响应数据的过程

接口测试：本质是基于某种协议，发送一个Request请求给服务器，然后服务器返回一个Response响应数据，然后对响应数据进行分析，判断是否与我们预期的返回一致，从而验证功能是否正确，这就是接口测试。

2.接口分类

系统内部接口和系统外部接口

系统内部接口：模块间的相互调用

系统外部接口又包括软件接口和硬件接口

软件接口包括服务器接口和外部接口

服务器接口：是浏览器与服务器的接口，通过http协议来实现浏览器和服务器间的数据传递

外部接口：外部接口常见的典型例子就是通过第三方登录、第三方支付等，通过调用第三方接口并返回当前的系统

二丶RESTful

1.概述

RESTful架构风格最初由Roy T. Fielding（HTTP/1.1协议专家组负责人）在其2000年的博士学位论文中提出。HTTP就是该架构风格的一个典型应用。从其诞生之日开始，它就因其可扩展性和简单性受到越来越多的架构师和开发者们的青睐。一方面，随着云计算和移动计算的兴起，许多企业愿意在互联网上共享自己的数据、功能；另一方面，在企业中，RESTful API（也称RESTful Web服务）也逐渐超越SOAP成为实现SOA的重要手段之一。时至今日，RESTful架构风格已成为企业级服务的标配。

REST即Representational State Transfer的缩写，可译为"表现层状态转化”。REST最大的几个特点为：资源、统一接口、URI和无状态。

2.RESTful架构风格的特点

1.资源

所谓"资源"，就是网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的实在。资源总要通过某种载体反应其内容，文本可以用txt格式表现，也可以用HTML格式、XML格式表现，甚至可以采用二进制格式；图片可以用JPG格式表现，也可以用PNG格式表现；JSON是现在最常用的资源表示格式。

2.统一接口

RESTful架构风格规定，数据的元操作，即CRUD(create, read, update和delete,即数据的增删查改)操作，分别对应于HTTP方法：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源，这样就统一了数据操作的接口，仅通过HTTP方法，就可以完成对数据的所有增删查改工作。也就是说处理资源通过http方法GET/POST/PUT/DELETE实现：

• GET（SELECT）：从服务器取出资源（一项或多项）。
• POST（CREATE）：在服务器新建一个资源。
• PUT（UPDATE）：在服务器更新资源（客户端提供完整资源数据）。
• DELETE（DELETE）：从服务器删除资源。

 3.URI

可以用一个URI（统一资源定位符）指向资源，即每个URI都对应一个特定的资源。要获取这个资源，访问它的URI就可以，因此URI就成了每一个资源的地址或识别符。

4.无状态

所谓无状态的，即所有的资源，都可以通过URI定位，而且这个定位与其他资源无关，也不会因为其他资源的变化而改变。

综上所述总结如下：

1.在RESTful中一切都认为是资源，且每个资源都有对应的URI标识

2.客户端通过GET/POST/PUT/DELETE等http方法对资源进行操作，即客户端通过http协议与服务器进行通信，并获取资源信息

三丶HTTP协议

1.URL篇

1.概述

http（超文本传输协议）是一个基于请求与响应模式的、无状态的、应用层的协议，常基于TCP的连接方式，HTTP1.1版本中给出一种持续连接的机制，绝大多数的Web开发，都是构建在HTTP协议之上的Web应用。

2.格式

HTTP URL (URL是一种特殊类型的URI，包含了用于查找某个资源的足够的信息)的格式如下：

http://host[":"port][abs_path]

http表示要通过HTTP协议来定位网络资源；host表示合法的Internet主机域名或者IP地址；port指定一个端口号，为空则使用缺省端口80；abs_path指定请求资源的URI；如果URL中没有给出abs_path，那么当它作为请求URI时，必须以“/”的形式给出，通常这个工作浏览器自动帮我们完成

a)输入：www.guet.edu.cn

浏览器自动转换成：http://www.guet.edu.cn/

b)http:192.168.0.116:8080/index.jsp

2.请求篇

http请求由三部分组成，分别是：请求行、消息报头、请求正文

请求行以一个方法符号开头，以空格分开，后面跟着请求的URI和协议的版本，格式如下：Method Request-URI HTTP-Version CRLF

消息报头以及请求正文在后面介绍

请求行举例如下：

其中 Method表示请求方法；Request-URI是一个统一资源标识符；HTTP-Version表示请求的HTTP协议版本；CRLF表示回车和换行（除了作为结尾的CRLF外，不允许出现单独的CR或LF字符）

3.响应篇

在接收和解释请求消息后，服务器返回一个HTTP响应消息。

HTTP响应也是由三个部分组成，分别是：状态行、消息报头、响应实体（正文）

状态行格式如下：

HTTP-Version Status-Code Reason-Phrase CRLF

其中，HTTP-Version表示服务器HTTP协议的版本；Status-Code表示服务器发回的响应状态代码；Reason-Phrase表示状态代码的文本描述

状态代码有三位数字组成，第一个数字定义了响应的类别，且有五种可能取值：

1xx：指示信息–表示请求已接收，继续处理

2xx：成功–表示请求已被成功接收、理解、接受

3xx：重定向–要完成请求必须进行更进一步的操作

4xx：客户端错误–请求有语法错误或请求无法实现

5xx：服务器端错误–服务器未能实现合法的请求

常见状态代码、状态描述、说明：

200 OK      //客户端请求成功

400 Bad Request  //客户端请求有语法错误，不能被服务器所理解

401 Unauthorized //请求未经授权，这个状态代码必须和WWW-Authenticate报头域一起使用

403 Forbidden  //服务器收到请求，但是拒绝提供服务

404 Not Found  //请求资源不存在，eg：输入了错误的URL

500 Internal Server Error //服务器发生不可预期的错误

503 Server Unavailable  //服务器当前不能处理客户端的请求，一段时间后可能恢复正常

eg：HTTP/1.1 200 OK （CRLF）

状态行举例：

状态码302举例：（重定向）

说明：在博客电商项目测试实战（一）中部署了windows环境的iwebshop项目，所以博主通过fiddler过滤获取本地请求localhost来抓取iwebshop的请求

现在抓取iwebshop登录接口的响应状态码302，重定向到http://localhost:8013/iwebshop/index.php?controller=ucenter

响应实体在后面进行介绍

4.消息报头

1.概述

HTTP消息由客户端到服务器的请求和服务器到客户端的响应组成。请求消息和响应消息都是由开始行（对于请求消息，开始行就是请求行，对于响应消息，开始行就是状态行），消息报头（可选），空行（只有CRLF的行），消息正文（可选）组成。

2.分类

HTTP消息报头包括普通报头、请求报头、响应报头、实体报头。

每一个报头域都是由名字+“：”+空格+值组成，消息报头域的名字是大小写无关的

HTTP消息报头举例：

a)普通报头

在普通报头中，有少数报头域用于所有的请求和响应消息，但并不用于被传输的实体，只用于传输的消息。

Cache-Control   用于指定缓存指令，缓存指令是单向的（响应中出现的缓存指令在请求中未必会出现），且是独立的（一个消息的缓存指令不会影响另一个消息处理的缓存机制），HTTP1.0使用的类似的报头域为Pragma。

请求时的缓存指令包括：no-cache（用于指示请求或响应消息不能缓存）、no-store、max-age、max-stale、min-fresh、only-if-cached

响应时的缓存指令包括：public、private、no-cache、no-store、no-transform、must-revalidate、proxy-revalidate、max-age、s-maxage.

为了指示IE浏览器（客户端）不要缓存页面，服务器端的JSP程序可以编写如下：response.sehHeader(“Cache-Control”,”no-cache”);

//response.setHeader(“Pragma”,”no-cache”);作用相当于上述代码，通常两者//合用

这句代码将在发送的响应消息中设置普通报头域：Cache-Control:no-cache

Date普通报头域表示消息产生的日期和时间

普通报头举例：

b)请求报头

请求报头允许客户端向服务器端传递请求的附加信息以及客户端自身的信息。

常用的请求报头

Accept

Accept请求报头域用于指定客户端接受哪些类型的信息。eg：Accept：image/gif，表明客户端希望接受GIF图象格式的资源；Accept：text/html，表明客户端希望接受html文本。

Accept-Charset

Accept-Charset请求报头域用于指定客户端接受的字符集。eg：Accept-Charset:iso-8859-1,gb2312.如果在请求消息中没有设置这个域，缺省是任何字符集都可以接受。

Accept-Encoding

Accept-Encoding请求报头域类似于Accept，但是它是用于指定可接受的内容编码。eg：Accept-Encoding:gzip.deflate.如果请求消息中没有设置这个域服务器假定客户端对各种内容编码都可以接受。

Accept-Language

Accept-Language请求报头域类似于Accept，但是它是用于指定一种自然语言。eg：Accept-Language:zh-cn.如果请求消息中没有设置这个报头域，服务器假定客户端对各种语言都可以接受。

Authorization

Authorization请求报头域主要用于证明客户端有权查看某个资源。当浏览器访问一个页面时，如果收到服务器的响应代码为401（未授权），可以发送一个包含Authorization请求报头域的请求，要求服务器对其进行验证。

Host（发送请求时，该报头域是必需的）

Host请求报头域主要用于指定被请求资源的Internet主机和端口号，它通常从HTTP URL中提取出来的

我们在浏览器中输入：http://www.guet.edu.cn/index.html

浏览器发送的请求消息中，就会包含Host请求报头域，如下：

Host：www.guet.edu.cn

此处使用缺省端口号80，若指定了端口号，则变成：Host：www.guet.edu.cn:指定端口号

User-Agent

我们上网登陆论坛的时候，往往会看到一些欢迎信息，其中列出了你的操作系统的名称和版本，你所使用的浏览器的名称和版本，这往往让很多人感到很神奇，实际上，服务器应用程序就是从User-Agent这个请求报头域中获取到这些信息。User-Agent请求报头域允许客户端将它的操作系统、浏览器和其它属性告诉服务器。不过，这个报头域不是必需的，如果我们自己编写一个浏览器，不使用User-Agent请求报头域，那么服务器端就无法得知我们的信息了

请求报头举例：

c)响应报头

响应报头允许服务器传递不能放在状态行中的附加响应信息，以及关于服务器的信息和对Request-URI所标识的资源进行下一步访问的信息。

常用的响应报头

Location

Location响应报头域用于重定向接受者到一个新的位置。Location响应报头域常用在更换域名的时候。

Server

Server响应报头域包含了服务器用来处理请求的软件信息。与User-Agent请求报头域是相对应的。下面是

Server响应报头域的一个例子：

Server：Apache-Coyote/1.1

WWW-Authenticate

WWW-Authenticate响应报头域必须被包含在401（未授权的）响应消息中，客户端收到401响应消息时候，并发送Authorization报头域请求服务器对其进行验证时，服务端响应报头就包含该报头域。

WWW-Authenticate:Basic realm=”Basic Auth Test!”  //可以看出服务器对请求资源采用的是基本验证机制。

响应报头举例：

c)实体报头

请求和响应消息都可以传送一个实体。一个实体由实体报头域和实体正文组成，但并不是说实体报头域和实体正文要在一起发送，可以只发送实体报头域。实体报头定义了关于实体正文（eg：有无实体正文）和请求所标识的资源的元信息。

常用的实体报头

Content-Encoding

Content-Encoding实体报头域被用作媒体类型的修饰符，它的值指示了已经被应用到实体正文的附加内容的编码，因而要获得Content-Type报头域中所引用的媒体类型，必须采用相应的解码机制。Content-Encoding这样用于记录文档的压缩方法，eg：Content-Encoding：gzip

Content-Language

Content-Language实体报头域描述了资源所用的自然语言。没有设置该域则认为实体内容将提供给所有的语言阅读

者。eg：Content-Language:da

Content-Length

Content-Length实体报头域用于指明实体正文的长度，以字节方式存储的十进制数字来表示。

Content-Type

Content-Type实体报头域用语指明发送给接收者的实体正文的媒体类型。eg：

Content-Type:text/html;charset=ISO-8859-1

Content-Type:text/html;charset=GB2312

Last-Modified

Last-Modified实体报头域用于指示资源的最后修改日期和时间。

Expires

Expires实体报头域给出响应过期的日期和时间。为了让代理服务器或浏览器在一段时间以后更新缓存中(再次访问曾访问过的页面时，直接从缓存中加载，缩短响应时间和降低服务器负载)的页面，我们可以使用Expires实体报头域指定页面过期的时间。Expires：Thu，15 Sep 2006 16:23:12 GMT

HTTP1.1的客户端和缓存必须将其他非法的日期格式（包括0）看作已经过期。

为了让浏览器不要缓存页面，我们也可以利用Expires实体报头域，设置为0，jsp中程序如下：response.setDateHeader(“Expires”,”0″);

5.请求正文

1.get:没有请求正文信息

2.post:请求正文与请求报头中间由空行隔开

6.响应实体（正文）

1.与消息报头之间由空行隔开

四丶如何开展接口测试

1.跟开发要接口文档

如微信公众平台API接口文档：

2.构造测试数据，编写测试用例

1.在聚合数据网站中，申请接口数据

a)数据中心我的接口中进行申请

b)申请成功后，则显示如下

c)点击接口查看API文档

d)查看错误参照码

e)查看示例代码

2.根据前面的微信公众平台API接口文档，编写测试用例

3.编写全国天气预报测试用例

五丶正式开展测试

1.WebTours环境搭建

1.安装strawberry-perl

2.解压WebTours.zip

1.在解压的WebTours目录运行StartServer.bat文件

2.运行之后会在右下方显示服务

3.在浏览器中输入http://192.168.4.12:1080/webtours/进入webtours登录页面，ip地址为上面图中的IP address中的任意一个（默认用户：jojo，默认密码：bean）

2.get请求接口

测试根据城市名/id查询天气接口

a) 根据接口文档输入正确的参数进行测试

b) 测试输入错误的key，查看返回的响应数据

测试天气种类及标识列表接口

a) 根据接口文档输入正确的参数进行测试

b) 测试输入错误的key，根据error_code的值来判断属于什么错误，并打印出来

3.post请求接口

测试根据GPS坐标查询天气接口

a) 根据接口文档输入正确的参数进行测试

b) 测试输入错误的GPS坐标

4.参数关联接口

测试web tours登录接口

a) 进行登录

b) 通过fiddler抓包工具过滤192.168.4.12hosts地址，来抓取web tours登录的接口地址并进行复制

c) 查看登录接口请求数据

d) 编写代码进行模拟登录接口测试

e) 运行代码，将服务器返回的结果与fiddler抓取web tours登录成功后返回的结果进行对比，模拟登录返回的响应数据中的title与抓取登录成功后返回的title不一致，则说明没有成功

f) 细心的话就可以发现在web tours登录页面登录成功抓取的登录接口中传递的userSession参数的值不是固定的，所以在代码中使用登录接口请求数据中的userSession值进行模拟登录，肯定是不对的，因为userSession值是与http://192.168.4.12:1080/webtours/nav.pl?in=home接口返回的响应数据中的userSession值一致的，在fiddler工具中搜索userSession即可得出除了http://192.168.4.12:1080/webtours/login.pl登录接口中请求中含有此参数，还在http://192.168.4.12:1080/webtours/nav.pl?in=home接口中存在（说白了web tours登录接口的请求过程为，首先进行登录页面会向webtours/nav.pl?in=home接口发送请求，服务器给我们返回userSession这个响应值，然后再调用webtours/login.pl登录接口时请求参数中需要携带userSession这个值，才能成功的登录）

g) 解决方法：找到原因后，那么就很简单了，在代码中向/webtours/nav.pl?in=home接口发送请求来获取响应数据，查看响应数中是否存在userSession值

h) 通过正则匹配获取响应数据中的userSession值

i) 将获取到的数据替换掉请求数据中userSession得值，并且使用建立的；连接通道向登录接口发送请求数据，最后打印出模拟登录接口成功返回的响应数据

5.使用unitest进行接口测试

1.使用unittest模块对全国天气预报根据城市名/id查询天气接口进行测试

2.使用unittest模块对全国天气预报天气种类及标识列表接口进行测试（测试正确的key和错误的key）

3.模拟快递100查询订单接口

a)首先在快递100进行订单查询

b)通过fiddler抓包工具抓取快递查询接口地址

c)进行测试模拟快递100获取快递信息

d)根据返回的json响应数据中的message字段来测试是否模拟成功

6.数据和代码分离

1.读取excel表中的数据

说明：在博主的Python接口自动化测试框架实战开发（一）中有使用过读取excel表的操作

2.封装读取excel表数据

a)通过遍历总行数和总列数来获取对应单元的数据并组成字典添加到列表中

b)运行代码，打印出列表以及遍历打印出列表字典中的a的值+b的值

c)如果对以上封装看不太懂的朋友，可以通过debug进行断点测试，查看数据生成的过程

3.通过unittest模块测试excel表中的数据a+b的值是否等于c

4.新建test_data02.xls文档，里面存放的数据为全国天气预报接口数据也就是cityname和key（正确的key和错误的key），通过封装的ReadExcel类来读取其中的内容，并使用unittest完成接口测试

a)首选通过read_excel方法获取test_data02.xls文档中的数据

b)编写代码，实现对excel文档数据进行遍历测试

c)执行测试，测试结果成功，与excel文档中预期结果一致