1、引言
1.1 文档版本
| 版本 | 作者 | 审批 | 备注 |
| V1.0 | XXXX | 创建测试方案文档 | |
1.2 项目情况
| 项目名称 | XXX |
| 项目版本 | V1.0 |
| 项目经理 | XX |
| 测试人员 | XXXXX，XXX |
| 所属部门 | XX |
| 备注 |
1.3 文档目的
本文档主要用于指导XXX-YY项目常用接口自动化测试工作的开展。本文档的主要目的在于提供项目接口自动化测试的技术方案、实施方案和计划方案等。
2、接口自动化实施目标
2.1 实施原则
XXX-YY项目采用接口自动化测试，主要目的是为了应对迭代版本测试过程中的重复工作任务，以期达到效果如下：
- 降低测试成本
- 提高测试效率
- 更频繁地执行覆盖重要接口
- 提供更高的准确性和一致性
- 节约时间成本
虽然能达到上述预期效果，但实际实施过程中需要注意的是，接口自动化的高效应用，对于被测系统有着更高的要求，也需要遵循合理的方法流程，现总结如下：
- 接口自动化的实施应该被用于解决测试过程中高重复性的工作，很大一部分是用于回归测试老的功能接口，否则其本身工作量投入会大于其收益，所以不能盲目对所有接口或功能追求自动化。
- 对于提测版本，自身稳定性需要有一定程度的保障。过于频繁的接口变动，会加大后续接口自动化的实施难度，增加自动化脚本维护地成本。
- 接口自动化的整体实现应采用分布进行，测试过程中优先覆盖功能稳定且比较重要的接口，进而逐步扩展到整体项目的接口回归。
- 接口自动化测试是一个长期的过程，随着项目版本的不停迭代优化，项目本身的接口也会不断优化或新开发，所以后续自动化测试脚本的代码维护和调优也具有可观的工作量。
2.2 接口自动化测试范围
系统范围：
| 自动化实施阶段 | 被测模块 | 功能接口范围 |
| 第一阶段 | 登录获取token，YY标签页 | |
| 第二阶段 | ||
阶段范围：
这里我们优先测试一下登录的接口和一些插入XXX功能的接口。
2.3 接口自动化测试任务
- 制定测试方案
脚本编码前，需要对项目有一个整体把握，合理预估接口数量与复杂度。结合版本迭代时间，预估自动化脚本开发时间，并制定出相应的接口自动化测试方案。
- 提取分析测试点
根据前面写好的接口自动化测试范围，分析每个接口的测试点，包含请求方式，传入参数，请求头，返回状态，返回数据等。这个过程中，需要和相对应的开发对接清楚在测试范围内的接口的相关信息，并提前在postman中逐一确认调通，必要时生成相应的测试文档或编写进入测试用例中。
- 搭建测试框架
此次接口自动化测试框架采用的是以Python语言为脚本开发语言，选用unittest接口测试框架。目的希望达成可配置，能自动运行脚本，自动生成测试报告并将生成的测试报告发送到指定邮件。
- 编写脚本代码
脚本首次实现不需要覆盖到每个接口。先预计挑选几个重要接口进行覆盖测试，等整体测试框架搭建好后，整体流程确认调通无误后，再后续维护完善脚本，覆盖更多的功能接口。
- 持续集成
同上，初次脚本代码完成后，需要对现有自动化脚本进行升级持续集成开发，不断完成尚未覆盖到的接口，将这些接口加入到自动化测试的范围内，使得整体自动化程度进一步加深，更大程度上节约人力和时间成本。
- 脚本维护
脚本维护是在整体自动化脚本阶段性完成后，将现有生成的交付物归档整理好给相应的负责人管理，并进行阶段性的更新整理维护。包含项目日常版本迭代维护过程中对接口有改动的部分，和后续新加入接口得自动化覆盖等。
3、接口自动化技术选型
3.1 整体体系
结合测试金字塔（从下到上依次是：单元测试，服务测试，用户界面测试）以及XXX-YY项目本身的流程特性考量，本次自动化实现主要是以接口自动化的形式来开展。整个自动化脚本以 Python3.X 中 requests 库为核心机制，以 unittest 为测试组织，以 HTMLTestRunner 生成最终测试报告，Jenkins 实现持续集成，并选取 Python3.X 作为编程语言实现。
3.2 核心技术
3.2.1 接口自动化执行库--Requests
首先，Requests 是使用 Python 语言编写，基于 urllib，采用 Apache2 licensed 许可证的 HTTP 库。它比一般的 urllib 等库更加方便、简洁，可以节约我们大量的工作，完全满足HTTP 测试需求，总结为一句话：Requests 是 Python 实现的简单易用的 HTTP 库。其次，Requests 库安装和导入非常方便。
pip3 install requests ## 安装 Requests 库
import requests ## 导入 Requests 库到项目中
我们可以使用该库实现以下各种方法：
requests.get("url.cn") # GET请求
requests.post("url.cn") # POST请求
requests.put("url.cn") # PUT请求
requests.delete("url.cn") # DELETE请求
requests.head("url.cn") # HEAD请求
requests.options("url.cn") # OPTIONS请求
3.2.2 测试组织和断言机制--unittest
unittest 模块是 Python 中自带的一个单元测试模块，我们可以用来做接口自动化代码级别的测试组织和断言机制。其中比较重要的小组件模块有：TestCase，TestSuit，TestLoader，TextTestRunner，TextTestResult等。
**TestCase：**用来编写逐条的测试用例，是所有测试用例的基类，他是 unittest 模块中最基本的组成单元。一个 testcase 就是一个测试用例，是一个完整的测试流程，包括测试前的环境搭建准备 setUp，执行测试代码和断言机制，以及测试一条用例完成后的环境还原 tearDown 等。
**TestSuit：**多个TestCase就组成了一个TestSuit（测试用例集），这是用来存放一条一条测试用例的集合。
