接口测试--测试工具:rap2 接口文档解析
通过百度 OCR 工具识别 rap2 登录中的验证码,从而实现登录~那我们今天来实战解析 rap2 的接口数据,生成我们所需要的接口数据
实践上手
文档分析
1、我们先通过 F12 看看哪个接口是我们需要的?对~就是你了!
2、将接口数据复制到https://www.json.cn/,我们来看看接口数据结构,看看有哪些信息是需要的
3、通过分析 properties 中的数据,发现 pos=1 为请求头,pos=2 为路径参数,pos=3 为 body 参数,name 为字段名,value 为字段值,parentId=1,没有父节点;parentId!=-1,为父节点
代码解析
上一期中,有小伙伴反馈说,可以输入 cookies 不?那这次优化一下吧~
实现 rap2 登录并获取数据
@classmethod
def rap_data(cls, id, cookies = None):
"""
获取接口文档数据
:param id: 接口文档id
:param cookies: 非必填,登录的cookies
:return: 返回json数据
"""
params = {"id": id}
if cookies:
try:
cls.cookies = dict([i.split("=", 1) for i in cookies.split("; ")])
except Exception as e:
raise Exception('cookies格式不对,请重新输入!')
try:
res = requests.get(url=UrlConfig.RAP_PROJRCT_URL, params=params, cookies=cls.cookies).json()
except Exception as e:
raise Exception('cookies过期了,请重新输入!')
return res
else:
login_result = False
#判断是否登录成功
while not login_result:
login_result = Rap2Data.rap_login()
res = requests.get(url=UrlConfig.RAP_PROJRCT_URL, params=params, cookies=cls.cookies).json()
return res
解析关键代码展示:执行主入口
class Rap2Parse(object):
@classmethod
def api_data(cls, id, cookies=None, module=None):
json_obj = Rap2Data.rap_data(id, cookies)
errMsg = json_obj.get("errMsg")
#获取报错信息,将其抛出(权限不足、不存在接口文档,接口都会返回errMsg)
if errMsg:
errMsg = errMsg + f"请将接口文档授权给{Account.RAP['email']}!"
raise Exception(errMsg)
if module is None:
#模块名不传的话,默认获取所有模块数据
json_list = json_obj['data']['modules']
else:
#模块名传入,获取对应的模块数据
json_list = jsonpath(json_obj, f"$.data.modules[?(@.name=='{module}')]")
#校验传入的模块名是否存在
if not json_list:
raise Exception(f"{module}模块名不存在")
# 接口文档标题名,作为后续的文件名
file_name = json_obj.get('data').get('name')
#对标题名特殊处理
special_str = r"[\/\\\:\*\?\"\<\>\|]"
file_name = re.sub(special_str, "-", file_name)
data = []
#遍历模块数据
for i in json_list:
modules_data = {}
#模块名
modules_data['modules'] = i['name']
#模块描述
modules_data['description'] = i['description']
interfaces = []
#遍历interfaces接口数据
for i, dto in enumerate(i['interfaces']):
cases_data = {}
#接口id
cases_data['api_id'] = i + 1
#接口名
cases_data['title'] = dto['name']
#接口描述
cases_data['description'] = dto['description']
#接口路径
cases_data['url'] = dto['url']
#接口请求方法
cases_data['method'] = dto['method']
#获取接口的入参和出参
properties_list = jsonpath