接口测试入门实践

简单接口搭建(表单/REST)

五步教会你写接口

首先要安装flask包: pip install flask

  1. 从flask中导入Flask类和request对象: from flask import Flask, request
  2. 从当前模块实例化出一个Flask实例:app=Flask(__name__)
  3. 编写一个函数来处理请求
    1. 从请求对象中获取数据:a=request.values.get("a");b=request.values.get("b")
      • request.params: 字典格式,存储请求中的url参数
      • request.form: 字典格式,存储请求中的表单数据
      • request.values: 字典格式, 包含params和form中的值
      • request.json: 字典格式, 存储json类型的请求数据, 如果请求类型非json, 值为空
    2. 进行业务处理: sum = int(a) + int(b)
    3. 组装并返回响应数据: return str(sum) # http一般使用字符串传输数据
  4. 为接口指定接口地址和接受的方法:@app.route("/add/", methods=["GET"]) # 写到函数上面(装饰器)
  5. 运行接口:
    最后添加:
if __name__ == "__main__":
app.run()

保存为***.py, 打开命令行,进入add.py所在目录,运行python ***.py(名称可以自定义)

完整代码

# 1. 导入包 
from flask import Flask, request
# 2. 实例化一个
app = Flask(__name__)
# 3. 编写一个接口处理方法
@app.route("/add/", methods=["GET","POST"]) # 4. 挂载路由(指定接口的url路径), 声明接口接受的方法
def add():  # 3.1 从请求中获取参数# request.values  {"a": "1", "b": "2"}a = request.values.get("a")b = request.values.get("b")# 3.2 业务操作sum = int(a) + int(b)# 3.3 组装响应并返回return str(sum)# 5. 运行接口
if __name__ == '__main__':app.run() # 默认5000端口,可以指定端口app.run(port=50001)

运行代码:

在浏览器窗口输入或者在Postman中输入:

http://localhost:5000/add/?a=1&b=2

访问结果:

REST类型接口实现

代码:

from flask import Flask, request, jsonifyapp = Flask(__name__)@app.route("/api/sub/", methods=["POST"])
def sub():if not request.json: # 如果请求数据类型非jsonreturn jsonify({"code": "100001", "msg": "请求类型错误", "data": None})if not "a" in request.json or not "b" in request.json: # 如果参数中没有a或者没有breturn jsonify({"code": "100002", "msg": "参数缺失", "data": None})a = request.json.get("a")b = request.json.get("b")result = str(float(a) - float(b)) # 使用float支持浮点数相减return jsonify({"code": "100000", "msg": "成功", "data": result}) # 使用jsonify将字典数据转换为json类型的相应数据if __name__ == '__main__':app.run()
使用Postman测试接口(Form/Json)
  1. 打开 Postman 应用。

  2. 创建一个新的请求:

    • 点击 Postman 左上角的 "+ New" 按钮来创建一个新的请求。
    • 给请求起一个名称,例如 "Subtract Numbers"。
  3. 配置请求参数:

    • 在请求的 URL 地址栏中输入接口的完整路径,例如 http://localhost:5000/api/sub/
    • 在请求方法下拉菜单中选择 "POST"。
    • 在 "Body" 选项卡中选择 "raw" 并选择数据格式为 "JSON (application/json)"。
    • 在请求体中输入 JSON 数据,例如:
      {"a": 5,"b": 2
      }
      

    • 发送请求:

      • 点击 Postman 左上角的 "Send" 按钮以发送请求。
    • 获取响应:

      • 在 Postman 中,您将会在下方的响应区域看到来自应用的响应。
      • 响应应该显示为 {"code": "100000", "msg": "成功", "data": "3.0"},其中 "data" 的值是参数 "a" 减去参数 "b" 的结果。
编写接口文档

接口测试基础

接口测试概念

接口测试是测试系统组件间接口的一种测试。
接口测试主要用于检测外部系统与系统之 间以及内部各个子系统之间的交互点。测试的重点是要检查数据的交换,传递和控制管理过 程,以及系统间的相互逻辑依赖关系等。

接口测试目的
  • 核心:保证系统的稳定
  • 手段:持续集成
  • 目的:提高测试效率,提升用户体验,降低产品研发成本
接口测试一般流程
  • 列出需求
  • 安排资源,编写接口用例 -> 用例评审
  • 编写接口测试代码 -> 代码评审codeReview
  • 执行接口测试
接口测试关注点
  • 功能:功能实现,实现与设计一致, 接口通过性测试
  • 健壮性: 边界值,容错性
  • 性能: 并发及压测
  • 稳定性: 长期运行的稳定性
  • 安全性: SQL注入, session依赖, 数字签名, http接口的安全性
常见接口种类
  • Http/Https接口: 通过http/https协议传送接口数据(通常按字符串/二进制传输), 如常见的网页表单, https安全性更好
  • RESTful Api: REST表述性状态传递. 一种设计风格,基于http/https协议, 把一切接口视为资源, 接口要分版本,在统一的域名下管理, 不同的方法(get/post..)做不同的事,通常请求及响应使用json格式
  • Web Service: SOAP简单面向对象协议, 基于http实现的一种RPC方案.接口返回一些对象,可以直接通过操作对象,实现我们需要的业务处理.使用xml格式传输数据
  • RPC接口: RPC为远程方法调用, 有不同的实现方案,基于TCP/Http协议的都有. RPC可以想我们本地导入和调用对象一样使用. Dubbo接口也是一种RPC接口.
常见接口数据类型
  • 请求数据类型(Content-Type):
    • application/x-www-form-urlencoded: 常规只有文本的网页表单
    • application/json: RESTful Api常用格式, 结构清晰, 含有多层嵌套
    • multipart/form-data: 既有文本,又有上传文件或富文本框的混合数据表单
    • text/xml: xml格式, RPC接口常用格式
  • 响应数据类型
    • string/html: 返回字符串或网页源码
    • json: RESTful Api常用响应格式, 结构清晰
    • xml: RPC接口常用格式
常见接口安全验证方式
  • Auth_1.0/Auth_2.0: 通用接口授权方式
  • Session依赖: 需要登录之后才能进行接口操作
  • Token验证: 先要使用自己的appid/appsecret通过获取token接口验证身份获取一个token(令牌,有一定有效期), 然后带着token访问接口
  • 数字签名: 将原本的参数按一定规则进行组合,配合时间戳或appsecret, 通过加密算法生成一个签名sign, 携带签名进行接口请求
常见接口请求方法
  • GET: 获取资源
  • POST: 修改资源
  • PUT: 上传资源
  • DELETE: 删除资源
  • HEAD: 只请求页面首部
  • PATCH: 补丁
  • OPTIONS: 运行客户端查看服务器性能
    ......
常见状态码(RESTful规范)
  • 200系: 成功
    • 200 OK - [GET]:获取资源成功
    • 201 CREATED - [POST/PUT/PATCH]:创建/修改成功
    • 202 Accepted - [*]:任务接受
    • 204 NO CONTENT - [DELETE]:删除成功
  • 300系: 重定向
    • 301 Moved Permanently: 永久重定向
    • 302 Found: 临时重定向
  • 400: 资源错误
    • 400 INVALID REQUEST - [POST/PUT/PATCH]:用户请求错误
    • 401 Unauthorized - [*]:没有权限(鉴权失败, 接口层)
    • 403 Forbidden - [*] 资源禁止访问(服务器层,没有访问权限)
    • 404 NOT FOUND - [*]:资源不存在
    • 405 Method Not Allowd: 访问的方法不允许, 如用POST访问只支持GET请求的接口
    • 406 Not Acceptable - [GET]:用户请求的格式不可得(比如用户请求JSON格式,但是只有XML格式)
    • 410 Gone -[GET]:资源被永久删除
    • 422 Unprocesable entity - [POST/PUT/PATCH] 当创建对象时,发生验证错误
  • 500系: 服务器内部错误(接口崩溃或有Bug)
    • 500 INTERNAL SERVER ERROR - [*]:服务器发生错误
接口业务类型
  • 返回数据型接口: 只从数据库读取数据
  • 业务操作型接口: 需要写数据库(接口测试需要要涉及参数化或环境清理)

快速上手接口测试

获取接口文档
  • Wiki
  • Word文档
  • Postman导出
  • 抽象接口定义
  • 接口管理平台
接口文档分析
  • 功能分析: 是否能满足业务(是否缺少某个前端需要的参数), 是否能满足所有业务场景(是否有漏开发接口, 比如只开发了单品接口,没开发套餐接口)
  • 设计分析: 是否有不规范字段(如,nickname, passwd);不规范格式(如sex,用男,女而不是1,2);是否有易混淆字段(如amount和total);是否有单词拼错;是否有和数据库字段对应但名称不一样的(易错)
  • 接口分析: 协议类型(http要考虑安全);请求方法(是否规范);请求编码格式(表单/Json/xml, 很多接口文档不声明,导致测试调试不通);接口授权方式;接口业务类型(关系到是否需要做参数化或环境清理); 返回值类型及结构(关系到怎么断言)
  • 接口依赖: 需要什么环境准备和业务场景, 依赖那些接口, 有那些动态数据, 预备环境怎么保障
  • 参数分析: 各个参数的参数类型,组成规则,是否允许不传,是否可以为空, 是否允许多传参
  • 业务分析: 如price字段必须和数据库中的商品的price字段一致,才能校验通过
  • 非功能性: 接口的技术实现方案是否合理, 能否满足高并发的性能要求, 边界值/极限值的处理是否合适, 是否前后端都有数据格式校验等(如精确度为秒级的订单号生成器,在高并发下会导致生成同一订单号的问题)
  • 其他: 如反爬,对headers的一些限制和校验, ip等限制
编写接口用例

Excel/TestLink/禅道

  • 单接口用例: 正常数据/边界数据/异常数据(健壮性)/并发(一致性)/性能/安全性(抓包截取伪造/SQL注入/跨域请求)
  • 场景用例: 列出常见的用户场景, 用接口进行覆盖, 业务场景压测(寻找某个环节的性能瓶颈)
TestCaseUrlMethodDataTypeabExceptedActualStatus
test_add_normal/api/add/GETUrl358
test_add_zero/api/add/POSTFORM000
test_add_negetive/api/add/POSTFORM-352
test_add_float/api/add/POSTFORM3.25.28.4
test_add_null/api/add/POSTFORM0
执行接口测试
  • Postman: 功能调试
  • Jmeter: 性能

接口自动化实践

五步教会你写接口自动化用例

需要安装三方包:requests pytest pytest-htmlpip install requests pytest pytest-html

  1. 导入requests模块
    import requests
  2. 组装请求参数和数据
    url = 'http://127.0.0.1:5000/add/'
    params = {"a":3, "b":5} # get请求url参数, 字典格式
    data = {"a":3, "b":5} # post请求请求数据, 字典格式
  3. 发送请求得到response对象
    resp = requests.get(url=url, params=params)
    resp = requests.post(url=url,data=data)
  4. 解析response对象
    • resp.text # 获取响应文本
  5. 断言结果
    assert resp.text == '8'
    完整代码:
# 1. 导入包
import requestsbase_url = "http://127.0.0.1:5005"# 2. 组装请求
def test_add_normal():# url  字符串格式url = base_url + "/add/"# data {} 字典格式data = {"a": "1", "b": "2"}# 3. 发送请求,获取响应对象response = requests.post(url=url, data=data)
# 4. 解析响应
# 5. 断言结果assert response.text == '3'

运行代码并在浏览器输入:

http://127.0.0.1:5005/add/
REST类接口自动测试方法

请求格式为json

三处不同:

  1. 必须通过headers指定内容类型为application/json: ```headers=
  2. 请求数据要转化为字符串: data=json.dumps(data) (使用json.dumps需要import json)
  3. json格式的响应数据,在接口调试通过和稳定的情况下可以使用response.json()解析为字典格式,进行断言

完整代码:

# 1. 导入包
import requests
import jsonbase_url = "http://127.0.0.1:5005"def test_sub_normal():url = base_url + "/api/sub/"headers = {"Content-Type": "application/json"} # 1. 必须通过headers指定请求内容类型为jsondata = {"a": "4", "b": "2"}data = json.dumps(data) # 2. 序列化成字符串response = requests.post(url=url, headers=headers, data=data)# 3. 响应解析 # 响应格式为: {"code":"100000", "msg": "成功", "data": "2"}resp_code = response.json().get("code") resp_msg = response.json().get("msg")resp_data = response.json().get("data")# 断言assert response.status_code == 200assert resp_code == "100000"assert resp_msg == "成功"assert resp_data == "2"

访问:在浏览器的地址栏中输入接口的完整URL,包括协议(通常是HTTP或HTTPS)、主机名或IP地址、端口号和路径。

http://127.0.0.1:5005/api/sub/

补充1: 感受Python黑科技之exec()动态生成用例:

数据文件: test_add_data.xls

TestCaseUrlMethodDataTypeabExceptedActualStatus
test_add_normal/api/add/GETUrl358
test_add_zero/api/add/POSTFORM000
test_add_negetive/api/add/POSTFORM-352
test_add_float/api/add/POSTFORM3.25.28.4
test_add_null/api/add/POSTFORM0

import requests
import xlrdbase_url = 'http://127.0.0.1:7890'# 1.打开excel
wb = xlrd.open_workbook("test_add_data.xls")
# 2. 获取sheet
sh = wb.sheet_by_index(0)  # wb.sheet_by_name("Sheet1")
# 行数 sh.nrows 列数 sh.ncols
# 获取单元格数据
# print(sh.cell(1,0).value)
# print(sh.nrows)
tpl = '''def {case_name}():url = base_url + '/add/'data = {{"a": "{a}", "b":"{b}"}}response = requests.get(url=url, data=data)assert response.text == '{expected}'
'''for row in range(1, sh.nrows):case_name = sh.cell(row,0).valuea = sh.cell(row, 4).valueb = sh.cell(row, 5).valueexpected = sh.cell(row, 6).valuecase = tpl.format(case_name=case_name, a=a, b=b, expected=expected)exec(case)

这个得需要调试,有的电脑可能一直提示拒绝连接

解决办法如下:

我的默认端口:7890

动态生成的用例支持pytest发现和执行

自动化接口用例运行
  1. 将自动化测试用例保存为test*.py,一个文件里可以写多个用例, 如上面两个接口保存为test_user.py
  2. 在自动化用例脚本所在目录打开命令行, 运行pytest(运行所有test开头的.py用例)或pytest test_user.py(只运行该脚本中用例)
  3. pytest一些参数
    • -q: 安静模式(不显示环境信息) pytest -q test_user.py
    • --html=report.html:执行完生成report.html报告(文件名可以自己指定)pytest test_user.py --html=test_user_report.html
    • --resultlog=test.log: 执行完成生成执行结果log文件pytest test_user.py --resultlog=run.log

requests库详解

请求方法
  • requests.get()
  • requests.post()
  • requests.delete()
  • .....
  • requests.session() # 用来保持session会话,如登录状态
请求参数
  • url: 接口地址, str url="http://127.0.0.1:5000/add/"
  • headers: 请求头, dict headers={"Content-Type": "application/json"}
  • params: url参数, dict params={"a":"1":"b":"2"}
  • data: 请求数据, dict data={"a":"1":"b":"2"}
  • files: 文件句柄, dict files={"file": open("1.jpg")}
  • timeout: 超时时间,单位s, str, 超过时间会报超时错误```requests.get(url=url,params=params,timeout=10)
响应解析
  • resp: 响应对象
  • resp.status_code: 响应状态码
  • resp.text # 响应文本
  • resp.json() # 响应转化为json对象(字典)-慎用:如果接口出错或返回格式不是json格式,使用这个方法会报错
  • resp.content # 响应内容, 二进制类型

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/147881.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

LeetCode【121. 买卖股票的最佳时机】

你才不是什么小人物,你在我这里,是所有的天气和心情。 给定一个数组 prices ,它的第 i 个元素 prices[i] 表示一支给定股票第 i 天的价格。 你只能选择 某一天 买入这只股票,并选择在 未来的某一个不同的日子 卖出该股票。设计一…

【Leetcode】滑动窗口合集

这里写目录标题 209.长度最小的子数组题目思路代码 3. 无重复字符的最长子串(medium)题目思路 11. 最大连续 1 的个数 III题目思路 1658. 将 x 减到 0 的最⼩操作数题目思路代码 904. 水果成篮题目思路代码 438.找到字符串中所有字母的异位词题目思路代码…

二十八、高级IO与多路转接之select

文章目录 一、五种IO模型(一)阻塞IO:(二)非阻塞IO:(三)信号驱动IO:(四)IO多路转接:(五)异步IO: 二、高级IO重要概念(一)同步通信 vs 异…

【STL】用哈希表(桶)封装出unordered_set和unordered_map

⭐博客主页:️CS semi主页 ⭐欢迎关注:点赞收藏留言 ⭐系列专栏:C进阶 ⭐代码仓库:C进阶 家人们更新不易,你们的点赞和关注对我而言十分重要,友友们麻烦多多点赞+关注,你们的支持是我…

pytorch_神经网络构建1

文章目录 pytorch简介神经网络基础分类问题分析:逻辑回归模型逻辑回归实现多层神经网络多层网络搭建保存模型 pytorch简介 为什么神经网络要自定义数据类型torch.tensor? tensor可以放在gpu上训练,支持自动求导,方便快速训练,同时支持numpy的运算,是加强版,numpy不支持这些 为…

python二次开发CATIA:导出Excel格式BOM

BOM是英文Bill of Material的缩写,中文翻译为“物料清单”,也称为产品结构表或产品结构树。它是计算机可以识别的产品结构数据文件,也是ERP的主导文件。BOM使系统识别产品结构,也是联系与沟通企业各项业务的纽带。ERP系统中的BOM的…

多线程经典代码案例及手动实现

目录 一.线程和多线程 二. 多线程的经典的代码案例 1.单例模式 2.阻塞队列 (1)概念介绍 (2)生产者消费者模型 (3)手动实现阻塞队列 (4)代码解释及问题分析 3.定时器 (1)概念介绍 (2)思路分析 (3)手动实现定时器 (4)代码解释及问题分析 问题一:优先级 问题二 :忙等…

基于SSM的电动车上牌管理系统(有报告)。Javaee项目。

演示视频: 基于SSM的电动车上牌管理系统(有报告)。Javaee项目。 项目介绍: 采用M(model)V(view)C(controller)三层体系结构,通过Spring SpringM…

Java基本数据类型和变量

目录 一、基本数据类型 1.1 整型 1.1.1 byte 1.1.2 short 1.1.3 int 1.1.4 long 1.2 浮点型 1.2.1 float 1.2.2 double 1.3 字符型 1.4 布尔型 二、变量 2.1 变量的概念 2.2 语法格式 2.3 整型变量 2.3.1 整型变量 2.3.2 长整型变量 2.3.3 短整型变量 2.3.…

MySQL之DQL

DQL是数据查询语言 SELECT语句 语法: SELECT {*,列名,函数等} FROM 表名;SELECT *:表示匹配所有列 FROM :提供数据源 例如:查询student表的所有记录 SELECT * FROM student;例如:查询学生姓名和地址: SELECT Stud…

学信息系统项目管理师第4版系列16_资源管理过程

1. 组建项目团队,建设项目团队和管理项目团队属于执行过程组 1.1. 【高22上选21】 1.1.1. 【高21上选25】 1.2. 3版 2. 【高19上案三】 2.1. 【高18上案三】 2.2. 【高23上案一】 3. 规划资源管理 3.1. 定义如何估算、获取、管理和利用团队以及实物资源的过…

mstsc无法保存RDP凭据, 100%生效

问题 即使如下两项都打勾,其还是无法保存凭据,特别是连接Ubuntu (freerdp server): 解决方法 网上多种复杂方法,不生效,其思路是修改后台配置,以使mstsc跟平常一样自动记住凭据。最后,如下的…

斯坦福数据挖掘教程·第三版》读书笔记(英文版)Chapter 10 Mining Social-Network Graphs

来源:《斯坦福数据挖掘教程第三版》对应的公开英文书和PPT。 Chapter 10 Mining Social-Network Graphs The essential characteristics of a social network are: There is a collection of entities that participate in the network. Typically, these entiti…

Python学习笔记之分支结构与循环结构

Python学习笔记之分支结构与循环结构 一、分支结构 使用关键字if、elif、else 练习1&#xff1a;使用分支结构实现分段函数求值 """分段函数求值""" x float(input("x "))if x > 1:y 3 * x - 5 elif x < -1:y 5 * x 3…

2023/10/4 -- ARM

今日任务&#xff1a;QT实现TCP服务器客户端搭建的代码&#xff0c;现象 ser&#xff1a; #include "widget.h" #include "ui_widget.h"Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget) {ui->setupUi(this);server new QTcpSe…

免费、丰富、便捷的资源论坛——Yiove论坛,包括但不限于阿里云盘、夸克云盘、迅雷云盘等等

引言 目前资源的数量达到了60000&#xff0c;六万多的资源意味着在这里几乎可以找到任何你想要的资源。 当然&#xff0c;资源并不是论坛的全部&#xff0c;其中还包括了技术交流、福利分享、最新资讯等等。 传送门&#xff1a;YiOVE论坛 - 一个有资源有交流&#xff0c;有一…

PCL 计算点云中值

目录 一、算法原理2、主要函数二、代码实现三、结果展示四、参考链接本文由CSDN点云侠原创,原文链接。如果你不是在点云侠的博客中看到该文章,那么此处便是不要脸的爬虫。 一、算法原理 计算点云坐标的中值点,首先对点云坐标进行排序,然后计算中值。如果点云点的个数为奇数…

计组—— I/O系统

&#x1f4d5;&#xff1a;参考王道课件 目录 一、I/O系统的基本概念 1.什么是“I/O”&#xff1f; ​编辑2.主机如何和I/O设备进行交互&#xff1f; 3.I/O控制方式 &#xff08;1&#xff09;程序查询方式 &#xff08;2&#xff09;程序中断方式 &#xff08;3&#x…

号卡推广管理系统源码/手机流量卡推广网站源码/PHP源码+带后台版本+分销系统

源码简介&#xff1a; 号卡推广管理系统源码/手机流量卡推广网站源码&#xff0c;基于PHP源码&#xff0c;而且它是带后台版本&#xff0c;分销系统。运用全新UI流量卡官网系统源码有后台带文章。 这个流量卡销售网站源码&#xff0c;PHP流量卡分销系统&#xff0c;它可以支持…

C#餐饮收银系统

一、引言 餐饮收银系统是一种用于管理餐馆、咖啡厅、快餐店等餐饮业务的计算机化工具。它旨在简化点餐、结账、库存管理等任务&#xff0c;提高运营效率&#xff0c;增强客户体验&#xff0c;同时提供准确的财务记录。C# 餐饮收银系统是一种使用C#编程语言开发的餐饮业务管理软…