大前端之前端开发接口测试工具postman的使用方法-简单get接口请求测试的使用方法-简单教学一看就会-以实际例子来说明-优雅草卓伊凡

大前端之前端开发接口测试工具postman的使用方法-简单get接口请求测试的使用方法-简单教学一看就会-以实际例子来说明-优雅草卓伊凡

背景

前端开发接口请求，调试，联调，接入数据，前端必不可少工具，postman是一个非常好用的工具。

实战开始

这是官网， 登录下载和安装就不用讲了吧，这个比较easy，然后对于api的接口请求，主要有以下方式，基础知识放这给大家看下

API接口主要的请求方式

API 请求的主要方式包括以下几种：

1. GET 请求：
   • 用于从服务器获取数据。
   • 请求的数据通常附加在 URL 后面。
   • GET 请求是幂等的，意思是无论调用多少次，结果都是相同的。
   • 示例：

GET /api/users

1. POST 请求：
   • 用于向服务器发送数据，通常用于提交表单或上传文件。
   • 数据通常在请求体中发送。
   • POST 请求可能会改变服务器的状态，因此不是幂等的。
   • 示例：

POST /api/users
        {
          "name": "John Doe",
          "email": "john.doe@example.com"
        }

1. PUT 请求：
   • 用于更新服务器上的数据。
   • 数据通常在请求体中发送。
   • PUT 请求是幂等的，意思是无论调用多少次，结果都是相同的。
   • 示例：

PUT /api/users/1
        {
          "name": "John Doe",
          "email": "john.doe@example.com"
        }

1. DELETE 请求：
   • 用于从服务器删除数据。
   • DELETE 请求是幂等的，意思是无论调用多少次，结果都是相同的。
   • 示例：

DELETE /api/users/1

1. PATCH 请求：
   • 用于更新服务器上的部分数据。
   • 数据通常在请求体中发送。
   • PATCH 请求不是幂等的，意思是结果可能会因多次调用而不同。
   • 示例：

PATCH /api/users/1
        {
          "email": "john.new@example.com"
        }

1. OPTIONS 请求：
   • 用于请求服务器支持的通信选项和功能。
   • 通常用于跨域请求的预检。
   • 示例：

OPTIONS /api/users

打开postman 熟悉下

左边collections 你可以当成文件夹，以下是基础知识

左侧请求部分：

1. Collections：
   • Collections 是组织相关 API 请求的集合，类似于文件夹的概念。你可以根据项目、模块等将请求归类到不同的 Collection 中。
2. Environments：
   • Environments 是存储环境变量的地方，方便在不同环境（如开发、测试、生产）之间切换。例如，API 基础 URL、身份验证令牌等可以作为环境变量存储。
3. History：
   • History 列表显示了你最近执行过的请求，便于快速访问和重新执行之前的请求。
4. APIs、Workspaces：
   • APIs：提供了一个地方来定义和管理你的 API，并提供文档化功能。
   • Workspaces：可以将相关的 Collections、Environments 和团队成员组织在一起，方便协作。

我们新建一个test，然后新建这个短信请求test

然后我们看看右侧的基础知识先，

右侧请求部分：

右侧是实际发送和查看请求的地方。主要包括以下部分：

1. Request URL：
   • 输入请求的完整 URL，包括协议、域名、路径和查询参数。
2. Request Method：
   • 选择请求方法，如 GET、POST、PUT、DELETE、PATCH 等。
3. Params：
   • 查询参数，可以在 URL 中添加键值对，常用于 GET 请求。
4. Authorization：
   • 设置请求的身份验证信息，如 Bearer Token、Basic Auth 等。
5. Headers：
   • 设置请求头部信息，如 Content-Type、Authorization 等。
6. Body：
   • 设置请求的主体内容，常用于 POST、PUT 请求。可以选择不同的格式，如 raw（JSON、XML）、form-data、x-www-form-urlencoded 等。
7. Tests 和 Pre-request Script：
   • Tests：可以编写测试脚本来验证响应结果。
   • Pre-request Script：可以编写预请求脚本来准备和修改请求参数。
8. Send 按钮：
   • 点击 Send 按钮发送请求，并在右下角显示响应结果，包括状态码、响应头、响应体等。

ok 基本理论清楚以后，我们实战开始

以简单实战接口测试

先以最近我们api大数据一个简单的月经周期计算来测试，这个大意就是发送最后月经开始日期，和平均月经周期可以预测下次来月经的时间。

接口地址： https://api.youyacao.com/api/yuejing

返回格式： JSON

请求方式： GET

请求示例： https://api.youyacao.com/api/yuejing?lastPeriodStart=2023-12-31&cycleLength=8

请求参数说明：

返回参数说明：

返回示例：

示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "nextPeriodStart": "2024-01-28",
        "ovulationStart": "2024-01-14",
        "ovulationEnd": "2024-01-18"
    }
}

那么这个就很简单啊，我们添加地址，方式选get

https://api.youyacao.com/api/yuejing

根据基础知识我们需要填写的参数lastPeriodStart和cycleLength ，一个是date类型，一个是int类型，好基础知识又在下面了，

基本数据类型：

1. 整型（Integer）：
   • int： 表示一个整数，例如 -3、0、42。
   • short： 短整型，表示范围较小的整数。
   • long： 长整型，表示范围较大的整数。
   • byte： 字节型，表示更小范围的整数，通常用于存储二进制数据。
2. 浮点型（Floating Point）：
   • float： 单精度浮点型，表示小数，例如 3.14。
   • double： 双精度浮点型，表示更精确的小数。
3. 字符型（Character）：
   • char： 表示单个字符，例如 ‘A’、’中’。
4. 布尔型（Boolean）：
   • boolean： 表示真（true）或假（false）值。

复杂数据类型：

1. 字符串（String）：
   • 表示一串字符，例如 “Hello, World!”。在大多数编程语言中，字符串属于复杂数据类型。
2. 数组（Array）：
   • 表示相同数据类型的集合，例如 int 数组、String 数组。

数据库特定数据类型：

1. 日期和时间（Date and Time）：
   • date： 表示日期，例如 ‘2025-02-11’。
   • time： 表示时间，例如 ‘14:30:00’。
   • timestamp： 表示日期和时间，例如 ‘2025-02-11 14:30:00’。
2. 文本（Text）：
   • varchar： 可变长度字符型，用于存储字符串。
   • text： 长文本型，用于存储较长的字符串。
3. 二进制（Binary）：
   • blob： 二进制大对象，用于存储二进制数据，例如图片、视频。

根据基础知识，那么我们假设，date上次来是2025年1月11日， int类型是整数，比如8天，因此我们是不是得填写

2025-01-11 和 8

点击send 一请求，我们得到了数据

我们需要在row中勾选格式，我们需要json格式，我们勾选raw 然后选择json格式

ok 成功得到我们返回的预测接口信息， 通常状态码 200表示 成功， 这里看到预测 下次月经开始时间为1月19日，开始时期1月13日，结束日期1月17日，好像有点不太准啊，你们试试吧。

{
    "code": 200,
    "msg": "success",
    "data": {
        "nextPeriodStart": "2025-01-19",
        "ovulationStart": "2025-01-13",
        "ovulationEnd": "2025-01-17"
    }
}

那么针对row 格式里面这些种类，具体是什么意思呢，这里基础知识奉上。

1. raw 格式：

• JSON：
  • 用于发送 JSON 格式的数据。
  • 适合 RESTful API 的请求和响应。
  • 示例：

json

{
  "name": "John Doe",
  "email": "john.doe@example.com"
}

• XML：
  • 用于发送 XML 格式的数据。
  • 常用于 SOAP API 或需要 XML 格式的请求。
  • 示例：

xml

<user>
  <name>John Doe</name>
  <email>john.doe@example.com</email>
</user>

2. form-data 格式：

• 用于发送包含文件和非文件字段的数据。
• 每个字段都可以有自己的 Content-Type。
• 常用于文件上传。
• 示例：

plaintext

Content-Disposition: form-data; name="name"

John Doe
Content-Disposition: form-data; name="email"

john.doe@example.com
Content-Disposition: form-data; name="file"; filename="example.txt"
Content-Type: text/plain

This is an example file.

3. x-www-form-urlencoded 格式：

• 用于发送键值对，数据会被编码为 key1=value1&key2=value2 的格式。
• 类似于 URL 查询参数，但在请求体中发送。
• 适合表单提交的数据。
• 示例：

plaintext

name=John+Doe&email=john.doe%40example.com

4. 其他 raw 格式：

• Text： 发送纯文本数据。
  • 示例：

plaintext

This is a plain text request body.

• HTML： 发送 HTML 格式的数据。
  • 示例：

html

<html>
  <body>
    <h1>Hello, World!</h1>
  </body>
</html>

5. binary 格式：

• 用于发送二进制数据，如文件的字节流。
• 适合发送非文本文件，如图像、视频等。

选择合适的格式：

• 根据 API 要求选择合适的格式来发送请求数据。
• JSON 和 form-data 是常见的选择，JSON 适合发送结构化数据，form-data 适合包含文件的请求。

总之本文目的已达成，前端开发必须可少学习接口请求测试。