Postman接口测试01|接口测试基础概念、http协议、RESTful风格、接口文档

news2024/12/27 21:29:19

目录

一、接口测试基础概念

1、什么是接口

2、接口的类型

3、什么是接口测试

4、为什么要做接口测试

5、接口测试的实现方式

6、什么是自动化接口测试？

二、接口返回的数据格式

1、三种格式

2、Json

三、接口协议

1、webservice协议

2、dubbo协议

3、*http协议和https协议（重要）

1️⃣基础概念

2️⃣什么是http协议

3️⃣URL格式 

4️⃣http请求

5️⃣http响应

四、传统风格和RESTful风格接口

1、传统风格接口

2、RESTful风格接口

五、接口测试的流程

1、接口文档

1️⃣什么是接口文档

2️⃣作用

3️⃣展现形式

4️⃣结构

2、接口文档解析

1️⃣登录接口为例

2️⃣员工修改接口为例 

一、接口测试基础概念

1、什么是接口

电脑：USB、投影仪（为了数据传输）

软件：统称API（application program interface）、微信提现和充值、支付宝支付（调用需要用到鉴权码：token、key、appkey）

接口包括：

  • 内部接口：开发人员自己开发的对自身系统提供的接口
  • 外部接口：开发系统调用外部的，微信，支付宝等

总结：接口是指一组预定义的函数、方法或协议，是数据交互的通道，允许不同的软件应用程序之间进行交互、数据交换和功能调用。它是软件组件之间的中介，定义了如何通过标准化的方式进行访问、调用和操作某个功能或服务。API接口通常由函数、类、数据结构等组成，并且通过一定的规则或协议提供服务。

2、接口的类型

按划分形式，大致分为3类

①按协议分。协议不同，接口类型不同。HTTP、TCP、UDP、IP、FTP、USB …..

②按语言划分。Java、Python、C++、Php ....

③按范围划分。系统之间和程序内部。

  • 系统之间：内部系统之间，内部系统和外部系统之间。
  • 系统内部：方法（函数）和方法（函数）之间。类和类之间。模块和模块之间。

3、什么是接口测试

测试系统或组件之间交互的数据的正确性，以及逻辑依赖关系的正确性！

做接口测试需要不借助前端页面或后端代码，就能组织数据并模拟客户端或服务器做接口测试，检查响应数据是否符合预期。

分类:
测试外部接口:是被测系统和外部系统之间的接口。(一般只要正常调用即可)
测试内部接口:是被测系统内部各个模块之间的接口。
                     ①内部接口提供给内部系统使用(一般只要正常调用即可)
                     ②内部接口提供给外部系统使用(测试必须非常全面，考虑各种异常场景或权限控制)

4、为什么要做接口测试

  • 提早介入，符合测试的质量控制前移原则
  • 接口测试可以发现页面操作发现不了的问题。如：支付密码，输入非数字、特殊字符。
  • 低成本高收益（接口的一个bug ，可能对应上层界面 N 个bug）
  • 接口测试，不同于传统的单元测试，站在用户的角度展开测试。

总结：

接口的本质是一组函数、方法或协议。

接口测试的本质是测试接口是否能正常的交互数据，权限控制，以及异常场景。

5、接口测试的实现方式

①工具实现：Postman、fiddler、jmeter

②代码实现：Python + UnitTest + request

6、什么是自动化接口测试？

利用工具、代码 代替人工，自动判断响应结果和预期结果 是否一致。依赖断言！

二、接口返回的数据格式

1、三种格式

接口返回的数据格式一共有三种：

  • Json格式（80%都使用这个）：约定俗成返回三组数据 {error_code:0,msg:"提现成功",data:[]}，其中，

             error_code表示错误码，0代表成功；

             msg代表对错误码的中文说明；

             data表示真正的返回数据

  • Html格式：

              <html>

                     <title></title>

                     <body>

                              <error_code></error_code>

                               ……

                      </body>

             </html>

  • Xml格式：

              <?xml?version="1.0" encoding="utf-8">

                               <error_code></error_code>

                               ……

             </xml>

2、Json

Json就是一种数据类型。由两组数据组成，且两组数据格式可以相互嵌套

  • MAP对象：键值对，{key:value , key:value}
  • 数组：[value1,value2,value3,]
Json数据例子​​

在线校验Json结构等功能的网站：www.bejson.com

三、接口协议

协议：就是规则！要求使用协议的双方，必须严格遵守！

1、webservice协议

接口地址：http://...................?wsdl

restful规则：get获取数据，post提交数据，delete删除数据

由于restful规则的出现，多个接口地址实现的功能可以由一个接口地址实现

2、dubbo协议

接口地址以dubbo://......开头

适用于少量数据的传输，大并发。

3、*http协议和https协议（重要）

1️⃣基础概念

接口地址：http://..........开头或者https://..........开头

https=http+ssl安全传输协议

2️⃣什么是http协议

http是超文本传输协议，基于请求和响应模式的应用层协议。主要用于浏览器和服务器之间交互数据,交互有两个部分：
请求：get，post，put，delete
响应：1XX信息，2XX成功，3XX重定向(跳转不传值)，4XX客户端错误，5XX服务器错误。

3️⃣URL格式 
  • URL：（Uniform Resource Locator）统一资源定位符，是互联网上标准资源的地址。HTTP使用URL来建立连接 和 传输数据
  • URL作用：建立连接、发送数据。
  • 语法格式：

①协议：http 和 https

②域名：本质 IP地址（定位网络环境中的一台主机）

③端口号：在网络主机上，定位一个应用。端口号可以省略。没有指定端口号，默认跟随协议

            ⚪ http 协议默认端口：80
            ⚪ https 协议默认端口：443

            （补充：MySql的默认端口是3306、redis的默认端口是6379） 

④资源路径：对应网页的源代码 或 网络中的一个数据资源（例如图片）

            ⚪ 资源路径可以为空（没有），相当于资源路径为 “/” 

            ⚪ 如有查询参数，资源路径为 ？之前 域名(端口) 之后的所有内容！ 

            ⚪ 如果没有查询参数，资源路径，从 域名(端口) 之后，直到结束。 

⑤查询参数：传参给网页源代码。

            ⚪ 以 ？ 与 资源路径 隔分
            ⚪ 查询参数可以有多个，之间用 & 隔分。
            ⚪ 参数参数的语法 k=v 对儿

4️⃣http请求
  • 作用：由 客户端 发送给 服务器；规定了发送给服务器的数据的语法格式 
  • 完整语法格式：请求行、请求头、空行、请求体

【补充】GET和DELETE请求不包含请求体，需要的参数或资源标识符通过URL指定；POST、PUT请求具有请求体，表示提交或更新的数据。

【补充】怎么查看http请求：任意网页→右键→“检查”→Network→在网页上执行需要的操作→一般出现的第一个就是http请求（→点击左上处🚫按钮即可清空目前请求）

 ①请求行：

  • 作用：指定请求方法、请求资源 
  • 语法格式： 包含了请求方法、URL、协议版本三部分

  • 请求方法：下面是常用的四种

            ⚪GET：查询。 —— 没有请求体

            ⚪POST：新增。—— 登录、注册主要使用。有请求体

            ⚪PUT：修改。—— 有请求体。

            ⚪DELETE: 删除。 —— 没有请求体

  • URL：数据资源的定位符。 协议://域名:端口/资源路径？查询参数&查询参数&...
  • 协议版本：指定HTTP协议的版本，HTTP/1.1或HTTP/1.2或HTTP/2.0，主要是HTTP/1.1。

②请求头：

  • 作用：向服务器描述 客户端（浏览器）的基本信息。
  • 语法：都是“k：v”形式的 键值对儿，需要记的是两对

            ⚪User-Agent：向服务器描述浏览器的类型。

            ⚪Content-Type：向服务器描述 请求体 的数据类型！

③空一行：标识请求头结束了

④请求体

  • GET、DELETE请求方法，没有请求体。
  • POST、PUT 请求方法，有请求体。
  • 请求体的数据类型，受 请求头中 Content-Type 的值 影响

5️⃣http响应
  • 作用：由 服务器 回发送给 客户端；规定了 服务器回发给客户端的 数据的 语法格式！
  • 完整语法格式：响应行（状态行）、响应头、空行、响应体

 ①状态行：

  • 语法格式：包含协议版本、状态码、状态码描述三部分

  • 协议版本：指示响应使用的HTTP协议版本HTTP/1.1或HTTP/1.2或HTTP/2.0，主要是HTTP/1.1。
  • 状态码：针对http请求，响应的状态

            ⚪1xx：信息类，表示请求已接受，继续处理

            ⚪2xx：成功。200 OK

            ⚪3xx：重定向。数据资源需要重定向访问

            ⚪4xx：客户端错误。404 Not Found 文件/资源 不存在。 403 Forbidden 文件/资源

                 存在，但是拒绝被访问（没有权限）

            ⚪5xx：服务器端错误。

  • 状态描述：对状态码的说明

②响应头

  • 作用：向客户端描述 服务器的基本信息。
  • 语法：k:v 键值对儿
  • Content-Type：向客户端描述 响应体 的数据类型！

③空一行

④响应体

  • http响应报文，大多数报文都是有响应体！成功的话给数据，不成功的话告诉错误的类型。
  • 响应体的数据类型，受 响应头中 Content-Type 的值影响。
  • 常见的类型：

            ⚪json 类型

            ⚪表单 类型

            ⚪图片 类型 

四、传统风格和RESTful风格接口

1、传统风格接口

  • 使用GET、POST 实现所有数据的 增删改查操作。
  • 针对 用户的某一个操作，URL 不唯一。
  • 状态码 统一使用 200

好处： 

  • 对开发的技术要求低。 只需要 get、post 方法即可。
  • 代码实现灵活。

2、RESTful风格接口

一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件。

REST:即(Representational State Transfer)的缩写。词组的翻译是“表现层状态转化”。如果-I个架构符合REST原则,就称它为RESTful架构。

  • 使用GET/POST/PUT/DELETE分别表示查、增、改、删
  • 使用一个URL对应一个唯一的资源。
  • 状态码，根据实际操作请求加以区分。

界定RESTful风格接口：

  • 请求方法 使用 get、post、delete、put 对应 查、增、删、改
  • 数据资源的定位符（URL）是否 唯一。
  • 在 URL中，不使用动词，替换使用名词。结合 请求方法，界定具体操作。

五、接口测试的流程

  • 1. 需求分析结合需求文档，需求分析
  • 2. 结合开发提供的接口文件（API文档，可以从开发拿，也可以抓包自己创建，也可以录制后自己创建），进行接口分析
  •      ①分析：接口地址，接口鉴权（鉴定是否有访问接口的权限）方式，接口入参，出参，是否有完善的错误码机制。
  • 3. 结合需求文档和API文档编写接口测试用例以及评审
  • 思路：
  •        正例：输入正常的入参，接口能够正常返回。(get/post)
  •        反例:
  •                鉴权反例：必填，鉴权码为空错误的鉴权码，鉴权码已过期……
  •                参数反例：必填，参数为为空，参数类型异常，参数的长度异常。
  •                错误码覆盖：根据业务而定。
  •                其他错误场景：接口黑名单，接口调用次数限制，分页场景。
  •                接口的兼容性：一个接口是否能兼容多个版本的前端。
  • 4. 执行接口测试用例
  •        工具：Postman、fiddler、jmeter
  •         代码：Python + UnitTest + requests
  • 5. 缺陷（bug）的管理和跟踪，回归i测试
  • 6. 生成测试报告
  • 7. Postman+Newman+Jenkins+git实现接口自动化持续集成（可选），并且生成测试报告和发送邮件（可选）。

1、接口文档

 1️⃣什么是接口文档

也叫 API 文档。是由开发人员编写。描述接口相关信息的文档。

2️⃣作用
  • 方便 前端开发人员和后端开发人员，在开发时进行对接。
  • 在人员更迭时，方便新入职的员工快速接手项目。
  • 方便测试人员编写接口测试用例。
3️⃣展现形式
  • 在线文档 （html）
  • 离线文档：word、xmind、pdf、Excel
4️⃣结构
  • 基本信息：

            ⚪接口描述
            ⚪URL：（协议+域名） + 资源路径
            ⚪请求方法：

  • 请求参数：

            ⚪请求头
            ⚪请求体（GET、DELETE 没有）

  • 返回结果：

            ⚪状态码、状态描述
            ⚪响应体

2、接口文档解析

1️⃣登录接口为例

http请求：

  • 请求行：

            ⚪请求方法：POST
            ⚪URL： http://ihrm-test.itheima.net/api/sys/login
            ⚪协议版本：默认 http/1.1

  • 请求头：

            ⚪Content-Type : application/json

  • 请求体：

            ⚪{ “mobile”：“13800000002”, ”password” : ”123456” }

http应答：

  • 响应行：

            ⚪状态码、状态描述：200 ok

  • 响应头：

            ⚪无

  • 响应体：

            ⚪第一种情况：{"success":true,"code":10000,"message":"操作成功！","data":"xxx"} 第一                   种情况
            ⚪第二种情况：{"success":false,"code":20001,"message":"用户名或密码错误","data":null}
            ⚪第三种情况：{"success":false,"code":99999,"message":"抱歉，系统繁忙，请稍后重
                 试！","data":null}

2️⃣员工修改接口为例 

http请求：

  • 请求行：

            ⚪请求方法：PUT
            ⚪URL：http://ihrm-test.itheima.net/api/sys/user/:target
            ⚪协议版本：默认 http/1.1

  • 请求头：

            ⚪Content-Type ：application/json
            ⚪Authorization ：Bearer f5050a1b-7919-444c-9ec4-3c1a7286536d

  • 请求体：

            ⚪{“username”：“张三”， “password”：“445566”， “departmentId”：“110”}
http应答：

  • 响应行：

            ⚪状态码、状态描述：200 ok

  • 响应头：

            ⚪无

  • 响应体：

            ⚪情况1，成功：{"success":true,"code":10000,"message":"操作成功！", "data":
                 {"id":"113749504"}}
            ⚪情况2，失败，权限不足：{"success":false,"code": 10003, "message":"权限不足！",                       "data":NULL}
            ⚪情况3，失败，系统繁忙：{"success":false,"code": 99999, "message":"抱歉，系统繁                     忙，请稍后重试！", "data": NULL}

 

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

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

HDR视频技术之十一：HEVCH.265 的 HDR 编码方案

HDR视频技术之十一：HEVCH.265 的 HDR 编码方案

前文我们对 HEVC 的 HDR 编码优化技术做了介绍&#xff0c;侧重编码性能的提升。 本章主要阐述 HEVC 中 HDR/WCG 相关的整体编码方案&#xff0c; 包括不同应用场景下的 HEVC 扩展编码技术。 1 背景 HDR 信号一般意味着使用更多比特&#xff0c;一般的 HDR 信号倾向于使用 10…
阅读更多...
ThinkPHP 8开发环境安装

ThinkPHP 8开发环境安装

【图书介绍】《ThinkPHP 8高效构建Web应用》-CSDN博客 《ThinkPHP 8高效构建Web应用 夏磊 编程与应用开发丛书 清华大学出版社》【摘要 书评 试读】- 京东图书 1. 安装PHP8 Windows系统用户可以前往https://windows.php.net/downloads/releases/archives/下载PHP 8.0版本&am…
阅读更多...
CAN201 Introduction to Networking（计算机网络）Pt.2 传输层

CAN201 Introduction to Networking（计算机网络）Pt.2 传输层

文章目录 3. Transport Layer&#xff08;传输层&#xff09;3.1 Multiplexing and demultiplexing&#xff08;多路复用和多路分解&#xff09;3.2 Connectionless transport&#xff1a;UDP3.3 Principles of reliable data transfer3.4 Pipelined communication3.5 TCP: con…
阅读更多...
linux系统上SQLPLUS的重“大”发现

linux系统上SQLPLUS的重“大”发现

SQL plus版本&#xff1a; [oraclepg-xc2 ~]$ sqlplus -v SQL*Plus: Release 19.0.0.0.0 - Production Version 19.3.0.0.0 操作系统&#xff1a;CentOS Linux 7 (Core) 数据库&#xff1a;Oracle 19c Version 19.3.0.0.0 同样的SQL脚本在windos CMD sqlplus 执行没问题。…
阅读更多...
Unity中实现人物残影效果

Unity中实现人物残影效果

今天火柴人联盟3公测了&#xff0c;看到一个残影的效果&#xff0c;很有意思&#xff0c;上网查询了一下实现方式&#xff0c; 实现思路&#xff1a; 将角色的网格复制出来&#xff0c;然后放置到新建的物体的MeshFilter组件上&#xff0c;每隔几十毫秒在玩家的位置生成一个&a…
阅读更多...
mysql mmm和mha对比

mysql mmm和mha对比

本文简单介绍MySQL的两个high availability方案&#xff0c;MMM和MHA。 MMM MMM(Master-Master replication managerfor Mysql)的基本组成如下&#xff0c; 主节点master1&#xff1a;承载写流量备主节点master2&#xff1a;replicate主节点master1的写流量&#xff0c;在主节…
阅读更多...
探秘“香水的 ChatGPT”：AI 开启嗅觉奇幻之旅！

探秘“香水的 ChatGPT”：AI 开启嗅觉奇幻之旅！

你没有看错&#xff0c;AI也能闻到味道了&#xff01;这是一家名为Osmo公司公布的信息&#xff0c;他们成功创造出了由AI生成的李子味道&#xff0c;快跟着小编一探究竟吧~ 【图片来源于网络&#xff0c;侵删】 Osmo公司的这项技术&#xff0c;通过分析香味的化学成分和人类嗅…
阅读更多...
uniapp实现为微信小程序扫一扫的功能

uniapp实现为微信小程序扫一扫的功能

引言 随着微信小程序的快速发展，越来越多的开发者开始关注和学习微信小程序的开发。其中，微信小程序的扫一扫功能是非常常用且实用的功能之一。通过扫描二维码，用户可以获取到相关的信息或者实现特定的功能。 正文 在过去，开发者需要使用微信开发者工具以及相关的开发文档…
阅读更多...
网络ip地址改成什么比较好

网络ip地址改成什么比较好

在数字化时代&#xff0c;网络IP地址作为设备在网络中的唯一标识&#xff0c;扮演着至关重要的角色。然而&#xff0c;随着网络环境的日益复杂和网络安全问题的频发&#xff0c;许多用户开始考虑更改自己的网络IP地址&#xff0c;以期获得更好的网络体验和安全保障。那么&#…
阅读更多...
iOS从Matter的设备认证证书中获取VID和PID

iOS从Matter的设备认证证书中获取VID和PID

设备认证证书也叫 DAC, 相当于每个已经认证的设备的标识。包含了 VID 和 PID. VID: Vendor ID &#xff0c;标识厂商 PID: Product ID&#xff0c; 标识设备的 根据 Matter 对于设备证书的规定&#xff0c;DAC证书subject应该包含VID 和 PID. 可通过解析 X509 证书读取subject…
阅读更多...
聊一聊 C#线程池 的线程动态注入

聊一聊 C#线程池 的线程动态注入

提高注入速度的两种方法 1. 降低GateThread的延迟时间 上一篇跟大家聊过 Result 默认情况下GateThread每秒会注入4个&#xff0c;底层逻辑是由 Blocking.MaxDelayMs250ms 变量控制的&#xff0c;言外之意就是能不能减少这个变量的值呢&#xff1f;当然可以的&#xff0c;这里我…
阅读更多...
【嵌入式C语言】指针数组结构体

【嵌入式C语言】指针数组结构体

指针与数组 指针与数组指针数组数组指针 多维数组数组名的保存 结构体定义结构体定义结构体变量使用typedef简化结构体声明访问结构体成员结构体内存分配字节对齐位域定义位域位域的限制示例 指针与数组 指针数组和数组指针是两个不同的概念&#xff0c;它们涉及到指针和数组的…
阅读更多...
HarmonyOS NEXT 实战之元服务：静态案例效果（二）

HarmonyOS NEXT 实战之元服务：静态案例效果（二）

背景&#xff1a; 前几篇学习了元服务&#xff0c;后面几期就让我们开发简单的元服务吧&#xff0c;里面丰富的内容大家自己加&#xff0c;本期案例 仅供参考 先上本期效果图 &#xff0c;里面图片自行替换 效果图代码案例如下&#xff1a; Index里面实现 import { authent…
阅读更多...
Android Studio超级详细讲解下载、安装配置教程（建议收藏）

Android Studio超级详细讲解下载、安装配置教程（建议收藏）

博主介绍&#xff1a;✌专注于前后端、机器学习、人工智能应用领域开发的优质创作者、秉着互联网精神开源贡献精神&#xff0c;答疑解惑、坚持优质作品共享。本人是掘金/腾讯云/阿里云等平台优质作者、擅长前后端项目开发和毕业项目实战&#xff0c;深受全网粉丝喜爱与支持✌有…
阅读更多...
从安全角度看 SEH 和 VEH

从安全角度看 SEH 和 VEH

从安全角度看 SEH 和 VEH 异常处理程序是处理程序中不可预见的错误的基本方法之一 https://learn.microsoft.com/en-us/dotnet/csharp/fundamentals/exceptions/ SEH——结构化异常处理程序 就其工作方式而言&#xff0c;异常处理程序与其他处理程序相比相当基础&#xff0…
阅读更多...
运行Zr.Admin项目（前端）

运行Zr.Admin项目（前端）

1.确认环境信息 我这里装的是node16.17版本的 官网16版本的最新为v16.20.2&#xff0c;下载链接https://nodejs.org/dist/v16.20.2/node-v16.20.2-x64.msi 2.去掉ssl 进入到Zr.Admin项目根目录&#xff0c;进入到ZR.vue 打开package.json 文件&#xff0c;删除启动命令配置中…
阅读更多...
uniapp登录

uniapp登录

第一步整登录 先整个appid APPID和APPSecret https://developers.weixin.qq.com/community/develop/article/doc/000ca4601b8f70e379febac985b413 一个账号只能整一个小程序 正确流程 调用uni.login https://juejin.cn/post/7126553599445827621 https://www.jb51.net/a…
阅读更多...
esp32学习：用虫洞ESP32S3-EYE开发板快速实现USB摄像头（UVC免驱）

esp32学习：用虫洞ESP32S3-EYE开发板快速实现USB摄像头（UVC免驱）

直接上干货&#xff1a;实现一个USB摄像头&#xff0c;免驱UVC设备。 硬件准备&#xff1a; 乐官方推荐的Cam开发板就是乐鑫带摄像头OV2604的esp32-s3-eye&#xff0c;我们虫洞esp32-s3-eye完全兼容这个板子哦&#xff0c;虫洞ESP32-S3-EYE 人脸识别 esp-cam升级 OpenCV LVGL …
阅读更多...
CMake 构建项目并整理头文件和库文件

CMake 构建项目并整理头文件和库文件

本文将介绍如何使用 CMake 构建项目、编译生成库文件&#xff0c;并将头文件和库文件整理到统一的目录中以便在其他项目中使用。 1. 项目结构 假设我们正在构建一个名为 rttr 的开源库&#xff0c;初始的项目结构如下&#xff1a; D:\WorkCode\Demo\rttr-master\|- src\ …
阅读更多...
磁盘结构、访问时间、调度算法

磁盘结构、访问时间、调度算法

目录 一、什么是磁盘&#xff1f; 二、磁盘分类 1、从磁头分 2、通过盘面分 三、一次磁盘读/写的时间 四、磁盘调度算法 1、先来先到服务算法FCFS 2、最短寻找时间优先SSTF 3、扫描算法&#xff08;SCAN&#xff09; 4、LOOk算法 5、循环扫描算法&#xff08;C-SCAN…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023