当前位置：首页 > news >正文

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

news 来源：原创 2025/7/22 12:10:32

一、接口测试基础概念

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>

<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结构等功能的网站：www.bejson.com

三、接口协议

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

1、webservice协议

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

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

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}

一、接口测试基础概念

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️⃣员工修改接口为例

相关文章：