Postman教程：新手快速上手指南

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

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

Postman的主要功能包括：

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

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

下载Postman

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

安装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。

创建一个新的请求

1. 打开Postman，点击左侧面板的“新建”按钮。
2. 输入请求名称，例如“获取用户信息”。
3. 选择请求类型，例如GET或POST。
4. 输入请求的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请求

• 在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请求

• 在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"

设置请求参数

• 在请求中添加参数可以通过以下步骤：
  • 在“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;
  });

• 发送请求后，可以在“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

• 监听器（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，确保它们按预期工作并满足性能要求。