文章目录
- 前言
- 一、实现登录接口对象封装和调用
- 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")