一、接口测试01

一、接口

1. 概念

• 接口就是：系统与系统之间，组件与组件之间，数据传递交互的通道。

  

2. 接口的类型

• 按协议划分：http、tcp、IP

• 按语言划分：C++、java、php 。。。

• 按范围划分：

  • 系统之间：

    • 多个内部系统之间
    • 内部系统与外部系统之间

    

  • 程序之间：

    • 方法与方法之间，函数与函数之间，模块与模块之间

      # 接口
      def eat(something):print(f'小鸟在吃{something}')# 使用接口，传递数据
      def bird():eat('苹果')bird()
      

二、接口测试

1. 概念

• 接口测试就是，对系统或组件之间的接口进行测试。校验传递的数据正确性和逻辑依赖关系的正确性！

原理

• 接口测试，主要针对的测试目标 —— 服务器

• 怎么测？

  • 模拟客户端，向服务器发送请求。

• 用什么测？

  • 工具：fiddler、postman、jmter
  • 代码：python + UnitTest框架 + Requests框架

• 测什么？

  • 测试 服务器针对客户端请求，回发的响应数据是否与预期结果一致！
    • 人眼对比
    • 断言

特点

• 符合质量控制前移的理念
• 可以发现一些页面操作发现不了的问题
• 接口测试低成本高效益
• 接口测试是从用户的角度对系统进行检测

实现方式

• 工具：JMeter、Postman、fiddler
• 代码：Python + Requests + UnitTest

什么是自动化接口测试？

• 借助工具、代码，模拟客户端发送请求给服务器，借助断言自动判断 预期结果和实际结果 是否一致！

三、HTTP协议

协议：就是规则。要求通信的双方必须严格遵守！

1. HTTP协议简介

• HTTP：（HyperText Transfer Protocol）超文本传输协议，是一个基于请求与响应模式的、应用层的协议，也是互联网上应用最为广泛的一种网络协议。

• 特征：

  1. 支持客户端/服务器模式
  2. 简单快速
  3. 灵活
  4. 无连接
  5. 无状态

2. URL格式

• 概念：（Uniform Resource Locator）统一资源定位符。
• 作用：在网络环境中，唯一的定义一个数据资源。

• 协议：http。 规定数据传输的方式。
• 域名（IP）：在网络环境中找到主机。—— 用 😕/ 与协议隔分
• 端口（port）：（常省略）在网络主机上，标识一个进程（应用程序）—— 用: 与域名
• 资源路径：标识网络资源（文件、图片、音视频、变量…）—— 用: / 与端口格分
• 查询参数：传递给资源路径对应的数据。—— 用 ? 与资源路径隔分。 查询参数内部 用 & 隔分多个kv对

2.1 练习

请写出以下URL的各个组成部分。这个URL没有写出端口号，它的端口是什么？

协议：http

域名：www.itcast.cn

端口号：8080（ 不是默认，只不过网络 网络通信常用！）

资源路径：/news/index.html

查询参数：uid=123&page=1

3. HTTP请求

作用：

• 客户端(app、浏览器)，发送请求给服务器时，使用的协议 —— http请求协议。
• 规定 发送给服务器的数据传输的语法格式。

3.1 整体格式

• 请求行：http请求第一行。请求方法 (空格) URL (空格) 协议版本
• 请求头：语法格式：k ：v
  • User-Agent：描述 请求发送端的 浏览器类型。
  • Content-Type：描述 请求体 的 数据类型！
• 空行：代表http请求头结束。
• 请求体：请求发送时携带的数据。数据类型 Content-Type 的值！
  • post 和 put 有请求体
  • get 和 delete 没有请求体

3.2 fiddler 抓包验证

3.3 请求行

• http 请求方法：大小写均可。
  • GET：查询。 —— 没有请求体
  • POST：添加。（登录时常用）
  • put: 修改。
  • delete: 删除。 —— 没有请求体

3.4 请求头

• 数据格式：k：v
• Content-Type：
  • application/json： JSON数据格式
  • application/x-www-form-urlencoded： form表单数据

3.5 请求体

• GET和DELETE 没有
• PUT 和POST有
• 数据类型受 Content-Type 值影响。

3.6 练习

• 以下是抓取的某个HTTP协议数据包的请求报文，请问其中，请求行，请求头，请求体分别是什么？

POST http://tpshop-test.itheima.net/index.php HTTP/1.1
Host: tpshop-test.itheima.net
Connection: keep-alive
Content-Length: 53
Accept: application/json, text/javascript, */*; q=0.01
Origin: http://tpshop-test.itheima.net
X-Requested-With: XMLHttpRequest
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)
AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.90
Safari/537.36
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Referer: http://tpshop-test.itheima.net/Home/user/login.html
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,zh;q=0.9
Cookie: is_mobile=0; province_id=1; city_id=2; district_id=3;
is_distribut=1; PHPSESSID=1b80tii77mhle0fqd2bg52ucg5; cn=0username=13800138006&password=123456&verify_code=8888

4. HTTP响应

作用：

• 服务器端，针对客户端发送的 http请求，回发响应数据。—— http应答！
• 规定 回发给客户端的数据组织格式。

4.1 整体格式

• 响应行（状态行）：协议版本 (空格) 状态码 (空格) 状态描述
• 响应头：语法格式：k:v
  • Content-Type: 描述 响应体中数据类型。
• 空行：代表响应头结束
• 响应体：绝大多数不为空。（请求成功：回发数据，失败：回发错误信息）
  • 数据类型受 Content-Type值影响。

4.2 状态行

• 状态码：

  • 1xx：代表指示信息。表请求已经被接收，等待继续处理。
  • 2xx：代表请求成功被处理、接收。 常见：200、201
  • 3xx：重定向，待访问的资源，需求重新指定路径访问。
  • 4xx：代表客户端错误。常见：404、 403
  • 5xx：访问器端错误。

• 状态码描述：一般与状态码 唯一对应。 200 —— ok； 404 —— file not found

4.3 响应头

• 语法格式：k：v
• Content-Type：值为 响应体 的数据类型。
• Content-Length: 响应体的大小。可以不写，浏览器会自动求取。一旦写，必须准确！

4.4 响应体

• 回发给客户端的 消息内容。常见的有 html网页、xml、json

4.5 练习

• 以下是HTTP协议的响应报文内容，请问，状态行、响应头、响应体分别是哪几个部分？

HTTP/1.1 200 OK
Server: nginx
Date: Mon, 29 Jun 2020 03:36:28 GMT
Content-Type: text/html; charset=UTF-8
Connection: keep-alive
Vary: Accept-Encoding
X-Powered-By: PHP/5.6.40
Set-Cookie: is_mobile=0; expires=Mon, 29-Jun-2020 04:36:28 GMT;
Max-Age=3600; path=/
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: no-store, no-cache, must-revalidate, post-
check=0, pre-check=0
Pragma: no-cache
Set-Cookie: user_id=3338; path=/
Set-Cookie: is_distribut=1; path=/
Set-Cookie: uname=13800138006; path=/
Set-Cookie: cn=0; expires=Mon, 29-Jun-2020 02:36:28 GMT; Max-
Age=-3600; path=/
Content-Length: 805{"status":1,"msg":"\u767b\u9646\u6210\u529f","result":
{"user_id":3338,"email":"","password":"519475228fe35ad067744465
c42a19b2","paypwd":null,"sex":0,"birthday":0,"user_money":"0.00
","frozen_money":"0.00","distribut_money":"0.00","underling_num
ber":0,"pay_points":100,"address_id":0,"reg_time":1590980161,"l
ast_login":1590980161,"last_ip":"","qq":"","mobile":"1380013800
6","mobile_validated":1,"oauth":"","openid":null,"unionid":null
,"head_pic":null,"province":0,"city":0,"district":0,"email_vali
dated":0,"nickname":"13800138006","level":1,"discount":"1.00","
total_amount":"0.00","is_lock":0,"is_distribut":1,"first_leader
":0,"second_leader":0,"third_leader":0,"token":"a26e177bd6506ff
f68c01fd13e742073","message_mask":63,"push_id":"0","distribut_l
evel":0,"level_name":"\u6ce8\u518c\u4f1a\u5458"},"url":""}

5. 传统风格接口

特点：

• 请求方法，只使用 get 和 post 即可。
• URL 不唯一。同一个操作可以对应不同的 URL
• 状态码的使用较单一。200 最常见。

6. RESTful风格接口

特点：

1. 每一个URL代表一种资源；
2. 客户端和服务器之间，传递这种资源的某种表现层；
   • 表现层：数据的不同表现形式（如：图片、文字表现同一个数据对象）
3. 客户端通过四个HTTP动词（GET、post、delete、put），对服务器端资源进行操作，实现"表现层状态转化"；
4. 接口之间传递的数据最常用格式为JSON。

四、接口测试流程

1. 分析需求，产生需求文档（产品）。
2. （开发产生接口文档）解析接口文档。
3. 产生 接口测试用例（送审）。
4. 执行 测试用例
   • 工具：postman、jmeter、fidller
   • 代码：python + Requests +UnitTest
5. 提交、跟踪缺陷。
6. 生成 测试报告。
7. （可选）接口自动化持续集成！

五、接口文档

1. 什么是接口文档

• 由开发人员编写，描述接口信息的文档。开发团队按接口文档进行开发工作，并要一直维护遵守。

2. 作用

1. 能够让前端开发与后台开发人员更好的配合，提高工作效率。（有一个统一参考的文件）
2. 项目迭代或者项目人员更迭时，方便后期人员查看和维护
3. 方便测试人员进行接口测试

3. 展现形式

• word 文档形式
• Excel 表格式形式
• pdf 文档形式。

4. 结构

• 基本信息：
  • 资源路径 （协议和域名在 “系统信息”中）
  • 请求方法
  • 接口描述
• 请求参数：
  • 请求头：
    • Content-Type。描述请求体的数据类型！
  • 请求体：
    • 实现该接口使用的 数据及对应类型。
• 返回数据：
  • 状态码 200
  • 错误码（自定义状态码）
    • 码值
    • 描述信息。

六、接口文档解析

• 接口文档的解析本质：从接口文档中，找出 http 请求所需要的 数据信息。
  • 主要包含：请求方法、URL 、请求头、请求体、响应状态码、描述。
• 以 “登录” 为例：
  • 请求方法：POST
  • URL：http://ihrm-test.itheima.net/api/sys/login
  • 请求头：Content-Type ：application/json
  • 请求体：{“mobile”:”13800000002”, “password”:”123456”}
  • 响应状态码：200
    • 错误码：
      • 10000：操作成功！
      • 20001：用户名或密码错误
      • 99999：抱歉，系统繁忙，请稍后重试！