文章目录
- 前言
- 一、实现登录接口对象封装和调用
- 1.0 登录接口的接口测试文档
- 1.1 接口对象层（封装）
- 1.2 测试脚本层（调用）
- 二、课程新增接口对象封装和调用
- 2.0 课程新增接口的接口测试文档
- 2.1 接口对象层（封装）
- 2.2 测试脚本层（调用）
- 三、合同上传接口对象封装和调用
- 3.0 合同上传的接口测试文档
- 3.1 接口对象层（封装）
- 3.2 测试脚本层（调用）
- 四、合同新增接口对象封装和调用
- 2.0 合同新增接口的接口测试文档
- 2.1 接口对象层（封装）
- 2.2 测试脚本层（调用）
- 总结
前言
一、实现登录接口对象封装和调用
1.0 登录接口的接口测试文档
接口信息：1.验证码：（1）地址：http://kdtx-test.itheima.net/api/captchaImage（2）方法：get
2.登录：（1）地址：http://kdtx-test.itheima.net/api/login（2）方法：Post（3）请求数据：（4）请求头：Content-Type: application/json（5）请求体：{"username": "admin", "password": " admin123","code":"2", "uuid":"验证码接口返回数据"}
1.1 接口对象层（封装）
封装的重要概念：
接口封装时，重点是依据接口文档封装接口信息，需要使用的测试数据是从测试用例传递的、接口方法被调用时需要返回对应的响应结果。封装是通过根据接口API文档封装，所以定义在API的目录下。
实现的基本步骤：
（1）导包操作：# 导包 import requests（2）创建接口的类：
# 创建接口类 class LoginAPI:（3）创建初始化方法：
初始化方法中需要指定接口的基本信息url。
# 初始化def __init__(self):# 指定url基本信息self.url_verify = "http://kdtx-test.itheima.net/api/captchaImage"self.url_login = "http://kdtx-test.itheima.net/api/login"（4）创建验证码、登录方法：
接口方法被调用时候，需要返回对应的响应结果信息。只有返回之后，才能在测试用例中使用倒响应结果的值。
# 验证码接口方法def get_verify_code(self):return requests.get(url=self.url_verify)# 登录接口方法def login(self, test_data):return requests.post(url=self.url_login, json=test_data)备注：
（1）登录接口方法中的test_data。
因为要从外部传入测试数据，所以在方法定义时候创建一个参数来接收传递的数据。
（2）json = test_data
此处数据是请求体json中的数据。
因为json数据的请求体在request格式中是通过json参数进行处理。即：json = test_data.
实现图示说明：
1.2 测试脚本层（调用）
测试脚本层说明：
- 重点关注测试数据准备和断言
- 重点关注业务流程的处理
- 直接调用接口对象层发送请求
实现的基本步骤：
（1）导包：
导入调用接口对象层中定义的登录接口api.login# 导包 from api.login import LoginAPI import pytest
（2）创建测试类：
测试类一般以Test开头进行命名。# 创建测试类 class TestLoginAPI:
（3）设置前置处理和后置处理
前置处理中先实例化一个登录接口的对象
# 前置处理def setup(self):# 实例化接口对象self.login_api = LoginAPI()# 后置处理def teardown(self):pass
（4）创建登录成功方法，并实现获取验证码和登录操作
# 1、登录成功def test01_login_success(self):# 获取验证码res_v = self.login_api.get_verify_code()print(res_v.status_code)print(res_v.json())# 打印uuid数据print(res_v.json().get("uuid"))# 登录login_data = {"username": "admin","password": "HM_2023_test","code": "2","uuid": res_v.json().get("uuid")# 此处调用验证码中的uuid数据}res_l = self.login_api.login(test_data=login_data)print(res_l.status_code)print(res_l.json())
实例图示说明：
输出结果：
二、课程新增接口对象封装和调用
2.0 课程新增接口的接口测试文档
接口信息：（1）URL：http://kdtx-test.itheima.net/api/clues/course（2）方法：Post（3）请求数据：（4）请求头：{ "Content-Type ": "application/json ", "Authorization": "xxx " }（5）请求体：{ "name": "测试开发提升课01", "subject": "6","price": 899,"applicablePerson": "2", "info": "测试开发提升课01"}
2.1 接口对象层（封装）
封装的重要概念：
接口封装时，重点是依据接口文档封装接口信息，需要使用的测试数据是从测试用例传递的、接口方法被调用时需要返回对应的响应结果。封装是通过根据接口API文档封装，所以定义在API的目录下。
实现的基本步骤：
（1）导包操作：# 导包 import requests（2）创建接口的类：
# 创建接口类 class CourseAPI:（3）创建初始化方法：
初始化方法中需要指定接口的基本信息url。
# 初始化def __init__(self):# 指定url基本信息self.url_add_course = "http://kdtx-test.itheima.net/api/clues/course"（4）创建课程添加方法：
接口方法被调用时候，需要返回对应的响应结果信息。只有返回之后，才能在测试用例中使用倒响应结果的值。
此处方法中定义了test_data, token都是需要从外部接收的数据，所以最终的返回里面也要有响应结果的值。如test_data是json格式的，token是headers格式中的数据。
def add_course(self, test_data, token):return requests.post(url=self.url_add_course, json=test_data, headers={"Authorization": token})
2.2 测试脚本层（调用）
实现的基本步骤：
（1）导包：
导入调用接口对象层中定义的登录接口api.login# 导包 import pytest from api.course import CourseAPI
（2）创建测试类：
测试类一般以Test开头进行命名。# 创建测试类 class TestContractBusiness:# 初始化token = None
（3）设置前置处理和后置处理
前置处理中先实例化一个登录接口的对象
# 前置处理def setup(self):# 实例化接口对象 self.course_api = CourseAPI()# 后置处理def teardown(self):pass
（4）创建课程新增方法，并实现课程新增操作
# 2、课程新增成功def test02_add_course(self):add_data = {"name": "测试开发提升课01", "subject": "6", "price": 899, "applicablePerson": "2","info": "测试开发提升课01"}response = self.course_api.add_course(test_data=add_data, token=TestContractBusiness.token)# 提取登录成功之后的token数据并保存在类的属性中TestContractBusiness.token = res_l.json().get("token")
三、合同上传接口对象封装和调用
3.0 合同上传的接口测试文档
接口信息：（1）URL： http://kdtx-test.itheima.net/api/common/upload（2）方法：Post（3）请求数据：（4）请求头：{ "Content-Type ": " multipart/form-data ", "Authorization": "xxx " }（5）请求体：{" file " : 合同文件"}思考：① 如何提交multipart/form-data数据？通过使用：requests.请求方法(url, data=None, json =None, headers=None, files =None)步骤① 读取文件数据f = open(" test.pdf ", " rb ")步骤② 设置请求数据response = requests.post(url=xxx, files= {" file " : f"})
3.1 接口对象层（封装）
实现的基本步骤：
（1）导包操作：# 导包 import requests（2）创建接口的类：
# 创建接口类 class ContractAPI:（3）创建初始化方法：
初始化方法中需要指定接口的基本信息url。
# 初始化def __init__(self):self.url_upload = "http://kdtx-test.itheima.net/api/common/upload"（4）创建课程添加方法：
接口方法被调用时候，需要返回对应的响应结果信息。只有返回之后，才能在测试用例中使用倒响应结果的值。
# 合同上传接口def upload_contract(self, test_data, token):return requests.post(url=self.url_upload, files={"file": test_data}, headers={"Authorization": token})
3.2 测试脚本层（调用）
实现的基本步骤：
（1）导包：
导入调用接口对象层中定义的登录接口api.login# 导包 import pytest from api.contract import ContractAPI
（2）创建测试类：
测试类一般以Test开头进行命名。# 创建测试类 class TestContractBusiness:# 初始化token = None
（3）设置前置处理和后置处理
前置处理需要先处理验证码获取和登录接口操作，依次为前提才能进行文件上传。
# 前置处理def setup(self):# 实例化接口对象self.login_api = LoginAPI()self.course_api = CourseAPI()self.contract_api = ContractAPI()# 1、登录成功def test01_login_success(self):# 获取验证码res_v = self.login_api.get_verify_code()print(res_v.status_code)print(res_v.json())# 打印uuid数据print(res_v.json().get("uuid"))# 登录login_data = {"username": "admin","password": "HM_2023_test","code": "2","uuid": res_v.json().get("uuid")}res_l = self.login_api.login(test_data=login_data)print(res_l.status_code)print(res_l.json())# 提取登录成功之后的token数据并保存在类的属性中TestContractBusiness.token = res_l.json().get("token")print(TestContractBusiness.token)# 后置处理def teardown(self):pass
（4）创建合同上传方法，并实现合同上传操作
# 3、上传合同成功def test03_upload_contract(self):# 读取pdf文件数据f = open("../data/test.pdf", "rb")response = self.contract_api.upload_contract(test_data=f, token=TestContractBusiness.token)print(response.json())
四、合同新增接口对象封装和调用
2.0 合同新增接口的接口测试文档
接口信息：新增合同：（1）url地址：http://kdtx-test.itheima.net/api/contract（2）方法：Post（3）请求数据：（4）请求头：{ "Content-Type ": "application/json ", "Authorization": "xxx " }（5）请求体：{ "name": "测试888", "phone": "13612345678", "contractNo": "HT10012003","subject": "6", "courseId": " 99", "channel": "0", "activityId": 77, "fileName": "xxx"}
2.1 接口对象层（封装）
封装的重要概念：
接口封装时，重点是依据接口文档封装接口信息，需要使用的测试数据是从测试用例传递的、接口方法被调用时需要返回对应的响应结果。封装是通过根据接口API文档封装，所以定义在API的目录下。
实现的基本步骤：
（1）导包操作：# 导包 import requests（2）创建接口的类：
# 创建接口类 class ContractAPI:（3）创建初始化方法：
初始化方法中需要指定接口的基本信息url。
# 初始化def __init__(self):self.add_contrat = "http://kdtx-test.itheima.net/api/contract"（4）创建合同添加方法：
接口方法被调用时候，需要返回对应的响应结果信息。只有返回之后，才能在测试用例中使用倒响应结果的值。
此处方法中定义了test_data, token都是需要从外部接收的数据，所以最终的返回里面也要有响应结果的值。如test_data是json格式的，token是headers格式中的数据。
# 新增合同接口def add_contract(self,test_data,token):return requests.post(url=self.add_contrat,json=test_data,headers={"Authorization": token})
2.2 测试脚本层（调用）
实现的基本步骤：
（1）导包：
导入调用接口对象层中定义的登录接口api.login# 导包 import pytest from api.contract import ContractAPI
（2）创建测试类：
测试类一般以Test开头进行命名。# 创建测试类 class TestContractBusiness:# 初始化token = None
（3）设置前置处理和后置处理
前置处理中先实例化一个登录接口的对象
# 前置处理def setup(self):# 实例化接口对象 self.contract_api = ContractAPI()# 后置处理def teardown(self):pass
（4）创建课程新增方法，并实现课程新增操作
# 4、新增合同成功def test04_add_contract(self):add_contract = {"name": "测试888","phone": "13612341888","contractNo": "HT20026194","subject": "6","courseId": 99,"channel": "0","activityId": 77,"fileName": "/profile/upload/2023/01/05/86e5a3b8-b08c-470c-a17d-71375c3a8b9f.pdf"}response = self.contract_api.add_contract(test_data=add_contract, token=TestContractBusiness.token)print(response.json())# 提取登录成功之后的token数据并保存在类的属性中TestContractBusiness.token = res_l.json().get("token")
