文章目录
- 前言
- 一、实现登录接口对象封装和调用
- 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)导包操作:
python# 导包 import requests
(2)创建接口的类:
python# 创建接口类 class LoginAPI:
(3)创建初始化方法:
初始化方法中需要指定接口的基本信息url。
python# 初始化 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)创建验证码、登录方法:
接口方法被调用时候,需要返回对应的响应结果信息。只有返回之后,才能在测试用例中使用倒响应结果的值。
python# 验证码接口方法 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
python# 导包 from api.login import LoginAPI import pytest
(2)创建测试类:
测试类一般以Test开头进行命名。
python# 创建测试类 class TestLoginAPI:
(3)设置前置处理和后置处理
前置处理中先实例化一个登录接口的对象
python# 前置处理 def setup(self): # 实例化接口对象 self.login_api = LoginAPI() # 后置处理 def teardown(self): pass
(4)创建登录成功方法,并实现获取验证码和登录操作
python# 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)导包操作:
python# 导包 import requests
(2)创建接口的类:
python# 创建接口类 class CourseAPI:
(3)创建初始化方法:
初始化方法中需要指定接口的基本信息url。
python# 初始化 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格式中的数据。
pythondef 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
python# 导包 import pytest from api.course import CourseAPI
(2)创建测试类:
测试类一般以Test开头进行命名。
python# 创建测试类 class TestContractBusiness: # 初始化 token = None
(3)设置前置处理和后置处理
前置处理中先实例化一个登录接口的对象
python# 前置处理 def setup(self): # 实例化接口对象 self.course_api = CourseAPI() # 后置处理 def teardown(self): pass
(4)创建课程新增方法,并实现课程新增操作
python# 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)
python# 提取登录成功之后的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)导包操作:
python# 导包 import requests
(2)创建接口的类:
python# 创建接口类 class ContractAPI:
(3)创建初始化方法:
初始化方法中需要指定接口的基本信息url。
python# 初始化 def __init__(self): self.url_upload = "http://kdtx-test.itheima.net/api/common/upload"
(4)创建课程添加方法:
接口方法被调用时候,需要返回对应的响应结果信息。只有返回之后,才能在测试用例中使用倒响应结果的值。
python# 合同上传接口 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
python# 导包 import pytest from api.contract import ContractAPI
(2)创建测试类:
测试类一般以Test开头进行命名。
python# 创建测试类 class TestContractBusiness: # 初始化 token = None
(3)设置前置处理和后置处理
前置处理需要先处理验证码获取和登录接口操作,依次为前提才能进行文件上传。
python# 前置处理 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)创建合同上传方法,并实现合同上传操作
python# 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)导包操作:
python# 导包 import requests
(2)创建接口的类:
python# 创建接口类 class ContractAPI:
(3)创建初始化方法:
初始化方法中需要指定接口的基本信息url。
python# 初始化 def __init__(self): self.add_contrat = "http://kdtx-test.itheima.net/api/contract"
(4)创建合同添加方法:
接口方法被调用时候,需要返回对应的响应结果信息。只有返回之后,才能在测试用例中使用倒响应结果的值。
此处方法中定义了 test_data, token都是需要从外部接收的数据,所以最终的返回里面也要有响应结果的值。如test_data是json格式的,token是headers格式中的数据。
python# 新增合同接口 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
python# 导包 import pytest from api.contract import ContractAPI
(2)创建测试类:
测试类一般以Test开头进行命名。
python# 创建测试类 class TestContractBusiness: # 初始化 token = None
(3)设置前置处理和后置处理
前置处理中先实例化一个登录接口的对象
python# 前置处理 def setup(self): # 实例化接口对象 self.contract_api = ContractAPI() # 后置处理 def teardown(self): pass
(4)创建课程新增方法,并实现课程新增操作
python# 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())
python# 提取登录成功之后的token数据并保存在类的属性中 TestContractBusiness.token = res_l.json().get("token")