Postman教程：新手快速上手指南-原创手记-慕课网

概述

Postman是一款强大的API开发和测试工具，本文将详细介绍如何下载和安装Postman，并指导你完成基本操作如创建和发送GET和POST请求。此外，还将介绍如何使用集合和环境来组织请求，以及如何进行更高级的测试和性能监控。本文提供了全面的Postman教程。

Postman简介与安装

什么是Postman

Postman是一个非常流行的API开发和测试工具，它可以帮助开发者创建、测试和迭代HTTP请求。Postman最初是Chrome浏览器的一个插件，现在也有独立的应用程序版本，可以跨平台使用。

Postman的主要功能包括：

进行各种HTTP请求（GET、POST、PUT等）
设置和响应参数
使用环境变量来管理不同的API环境
创建和使用集合来组织不同类型的请求
生成和查看请求的时间线
使用监听器记录请求和响应数据
生成复杂的测试套件和脚本

使用Postman，开发者可以方便地测试和调试API，确保它们按照预期工作，同时也可以帮助其他团队成员更好地了解API的设计和功能。

Postman的下载与安装

下载Postman

访问Postman的官方网站：https://www.postman.com/downloads/
根据自己的操作系统选择相应的版本进行下载。

安装Postman

Windows安装
- 下载完成后，双击下载的installer文件进行安装。
```
Installer for Windows
```
- Follow the installation wizard's instructions
- Once the installation is complete, launch Postman from the Start menu or desktop icon
macOS安装
- 下载完成后，双击下载的.dmg文件，拖动Postman到Applications文件夹。
```
.dmg file
```
- Open the .dmg file
- Drag the Postman app to the Applications folder
- Once the installation is complete, open the Postman app from Applications
Linux安装
- 下载完成后，使用解压命令解压下载的.tar.gz文件。
```
.tar.gz file
```
- Use the following command to extract: tar xvzf Postman.tar.gz
- Navigate to the extracted folder and run the Postman executable

安装完成后，可以启动Postman并开始使用它来测试和开发API。

Postman的基本操作

创建和管理API请求

创建一个新的请求

打开Postman，点击左侧面板的“新建”按钮。
输入请求名称，例如“获取用户信息”。
选择请求类型，例如GET或POST。
输入请求的URL，例如https://jsonplaceholder.typicode.com/users/1。

发送请求

在创建请求后，点击请求标签右侧的“发送”按钮，Postman将发送请求并显示响应。

示例URL：https://jsonplaceholder.typicode.com/users/1

Type: GET
URL: https://jsonplaceholder.typicode.com/users/1

如果请求成功，响应数据将显示在“Body”区域。

{
"id": 1,
"name": "Leanne Graham",
"username": "Bret",
"email": "Sincere@april.biz",
"address": {
"street": "Kulas Light",
"suite": "Apt. 556",
"city": "Gwenborough",
"zipcode": "92998-3874",
"geo": {
  "lat": "-37.3159",
  "lng": "81.1496"
}
},
"phone": "1-770-736-8031 x56442",
"website": "hilfiker-caruana.com",
"company": {
"name": "Romaguera-Jacobson",
"catchPhrase": "Multi-layered client-server neural-net",
"bs": "harness real-time e-markets"
}
}

使用集合和环境进行组织

创建集合

集合（Collections）是将一组相关的请求组织在一起的方式。
在左侧面板中，点击“集合”标签，点击“新建”按钮创建新的集合。
输入集合名称，例如“我的API测试”。

添加请求到集合

在创建或打开集合后，可以在集合列表中选择该集合，在集合下创建新的请求。
也可以将现有的请求拖放到集合列表中。

使用环境

环境（Environments）用于存储配置信息，例如API的URL或API密钥。
在左侧面板中，点击“环境”标签，点击“新建”按钮创建新环境。

输入环境名称，例如“开发环境”，并添加变量和相应的值。

{
"ENV": "development",
"baseURL": "http://api.example.com",
"api_key": "123456"
}

在请求中使用变量：

URL: {{baseURL}}/users
Headers: 
- key: "X-API-KEY"
- value: {{api_key}}

发送GET和POST请求

GET请求的创建与测试

创建GET请求

在Postman中创建一个新的请求。
选择请求类型“GET”。
输入URL，例如https://jsonplaceholder.typicode.com/todos/1。

测试GET请求

点击“发送”按钮来发送GET请求。

执行结果将显示在“Body”区域。

{
"userId": 1,
"id": 1,
"title": "delectus aut autem",
"completed": false
}

设置GET请求的Header

如果需要在请求中添加自定义头信息，可以在“Headers”标签页中添加自定义Header。
- 例如，添加一个自定义Header key: "X-Custom-Header"，value: "custom_value"。
```
Headers:
```
- key: "X-Custom-Header"
- value: "custom_value"

POST请求的创建与测试

创建POST请求

在Postman中创建一个新的请求。
选择请求类型“POST”。
输入URL，例如https://reqres.in/api/users。
在“Body”标签下，选择“raw”选项，并将“Type”设置为“JSON”。

测试POST请求

在“Body”区域输入以下JSON数据：

{
"name": "John Doe",
"job": "Software Engineer"
}

点击“发送”按钮发送请求。

执行结果将显示在“Body”区域。

{
"id": 123,
"name": "John Doe",
"job": "Software Engineer"
}

设置POST请求的Header

如果需要在请求中添加自定义头信息，可以在“Headers”标签页中添加自定义Header。
- 例如，添加一个自定义Header key: "X-Custom-Header"，value: "custom_value"。
```
Headers:
```
- key: "X-Custom-Header"
- value: "custom_value"

使用Postman进行测试

设置请求参数和断言

设置请求参数

在请求中添加参数可以通过以下步骤：
- 在“Params”标签下，点击“Add”按钮，输入参数名称和值。
- 例如，添加一个参数userId，值为1。
```
Params:
```
- key: "userId"
- value: 1
添加完参数后，点击“发送”按钮发送请求。

设置断言

断言用于验证API响应是否符合预期。
在请求面板中，点击“Tests”标签。

输入断言代码，例如：

检查响应状态码是否为200。

pm.test("Status code is 200", function() {
pm.response.to.have.status(200);
});

检查响应体中的特定字段。

pm.test("Response contains 'name' field", function() {
pm.expect(pm.response.json().name).to.exist;
});

测试API响应

发送请求后，可以在“Tests”标签下查看断言结果。
Postman还提供了详细的响应信息，包括响应头、响应体以及执行时间。
可以通过“Preview”选项查看响应数据的预览。
```
Headers:
```

Body:
{
"id": 1,
"name": "John Doe",
"job": "Software Engineer"
}


# 数据库查询与接口测试

## 通过Postman进行数据库查询
- Postman本身并不支持直接进行数据库查询，但可以通过API接口来查询数据库。
- 比如，一些数据库支持通过HTTP请求来查询数据，例如MySQL、PostgreSQL等。
- 一个常见的示例是通过RESTful API来查询数据库。

### 示例：查询MySQL数据库
- 假设有一个RESTful API接口，可以通过发送GET请求来查询MySQL数据库中的数据。
- URL格式：`http://api.example.com/users`
- 发送GET请求到该URL，响应体将包含查询到的数据。
- 示例请求：
  ```bash
 Type: GET
URL: http://api.example.com/users
Headers:
  - key: "Content-Type"
  - value: "application/json"

响应示例：

{
"users": [
{
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com"
},
{
  "id": 2,
  "name": "Jane Doe",
  "email": "jane@example.com"
}
]
}

测试接口的稳定性与性能

测试接口的稳定性可以通过多次发送请求来验证接口是否稳定，例如通过脚本自动化发送请求。
测试接口的性能可以通过Postman的“Monitors”功能来实现。
Monitors允许你设置定时任务来定期检查API的状态。

示例：使用Monitors测试接口性能

在Postman中创建一个新的Monitor。
在Monitor中配置请求，例如设置请求频率为每小时一次。

启动Monitor后，Postman将定期发送请求并记录响应时间。

Monitor settings:
- Frequency: Every hour
- URL: http://api.example.com/users
- Request Type: GET

Postman的高级功能

使用监听器记录请求与响应

监听器（Listeners）允许你记录详细的请求和响应信息。
在请求面板中，点击“Monitors”标签。
选择并启用监听器，例如“Event Listeners”。
监听器可以记录请求的各种信息，包括请求时间、请求头、响应头等。

示例：使用监听器记录请求

在请求面板中启用“Event Listeners”。

发送请求后，打开“Monitors”标签，查看监听器记录的信息。

Event Listeners:
- Request Time: 16:30:00
- Request Headers:
- Content-Type: application/json
- Accept: application/json
- Response Headers:
- Content-Type: application/json
- Response Time: 100ms

导入导出集合与环境信息

导入导出集合和环境信息可以通过JSON文件来实现。
导出集合或环境：
- 在“Collections”或“Environments”标签下，点击“Import/Export”按钮。
- 选择“Export”，选择导出格式（JSON）并保存文件。
导入集合或环境：
- 在“Collections”或“Environments”标签下，点击“Import/Export”按钮。
- 选择“Import”，浏览并选择要导入的JSON文件。
- 点击“导入”按钮完成导入。

示例：导出集合

在“Collections”标签下，点击“Import/Export”按钮。
选择“Export”，选择导出格式为JSON。
浏览并选择保存路径，完成导出。
```
Export Collection:
```
Format: JSON
Save as: my_collection.json

通过这些功能，你可以更好地管理和测试API，确保它们按预期工作并满足性能要求。