Postman入门：新手必备教程

概述

这篇文章提供了Postman入门的全面指南，包括下载和安装方法、界面介绍、创建和发送API请求的基本步骤。此外，还详细讲解了如何使用环境变量管理数据、创建测试集合以及如何在团队中进行协作。

Postman入门：新手必备教程 Postman简介与安装

Postman是什么

Postman 是一个功能强大的应用程序，用于测试API接口。它可以帮助你发送各种HTTP请求（如GET、POST、PUT、DELETE等），查看响应结果，并且支持高级功能，如环境变量、测试脚本、集合管理等。Postman不仅适合开发者用来测试API，也适合产品经理、测试人员用来调试API接口。

Postman的下载与安装方法

你可以通过访问Postman官网 https://www.postman.com/downloads/ 下载最新版本的Postman。根据你的操作系统（Windows、macOS、Linux等），选择相应的安装包进行下载。下载完成后，按照提示进行安装即可。

安装步骤

1. 访问 https://www.postman.com/downloads/。
2. 选择适合你操作系统的安装包，点击下载。
3. 打开下载的安装包，根据系统提示完成安装。
4. 安装完成后，打开Postman应用程序，并完成初始化设置（如登录、设置等）。

Postman的界面介绍

启动Postman后，你会看到如下界面：

• 左侧面板：这里可以创建新的API请求、新建或导入集合（Collection）以及查看环境变量（Environment）。
• 中间区域：这里是请求详情的编辑区域，可以设置请求方法、URL、参数等。
• 右侧区域：这里是响应结果的展示区域，可以查看响应状态码、响应头以及响应体。

左侧面板功能

• Collections：用于管理API请求的集合。
• Environments：用于管理环境变量，方便你在不同的测试环境中切换。
• Requests：用于创建和管理单个API请求。

中间区域功能

• Request Name：输入请求的名称。
• Request Method：选择请求方法，如GET、POST、PUT、DELETE等。
• URL：输入请求的URL。
• Params：设置URL参数。
• Body：设置请求体，包括JSON、Form-data、x-www-form-urlencoded等。

右侧区域功能

• Headers：显示响应头信息。
• Body：显示响应体信息。
• Cookies：显示响应的Cookies信息。
• Preview：显示响应体的预览格式。

创建第一个API请求

如何创建新的请求

要创建一个新的API请求，可以按照以下步骤操作：

1. 在左侧面板的“Collections”下点击“+”，然后选择“New Request”。
2. 在新弹出的窗口中输入请求的名称，如“Get Users”。
3. 点击“Request Name”旁边的“New”按钮，创建新的请求。

示例代码

// 新建一个名为 "Get Users" 的请求
// 请求方法：GET
// 请求URL：https://jsonplaceholder.typicode.com/users

GET请求与POST请求的区别

GET请求用于从服务器获取数据，如查询用户信息等。POST请求用于向服务器提交数据，如新增用户等。

GET请求示例

// GET请求示例
// 请求URL：https://jsonplaceholder.typicode.com/users

POST请求示例

// POST请求示例
// 请求URL：https://jsonplaceholder.typicode.com/posts
// 请求体：
{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

基本请求参数的设置

可以通过在URL中添加参数来设置GET请求中的参数。对于POST请求，可以在Body标签页中设置参数。

GET请求参数示例

// GET请求参数示例
// 请求URL：https://jsonplaceholder.typicode.com/users?userId=1

POST请求参数示例

// POST请求参数示例
// 请求URL：https://jsonplaceholder.typicode.com/posts
// 请求体：
{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

编辑JSON数据的步骤

在Postman的Body标签页中，选择“raw”和“JSON”选项，可以编辑请求体中的JSON数据。

示例代码

{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

使用Postman发送请求

发送GET与POST请求的步骤

要发送一个GET或POST请求，可以按照以下步骤操作：

1. 选择请求方法（GET或POST）。
2. 输入请求的URL。
3. 如果是POST请求，设置请求体。
4. 点击“Send”按钮发送请求。

示例代码

// 发送GET请求
// 请求URL：https://jsonplaceholder.typicode.com/users

// 发送POST请求
// 请求URL：https://jsonplaceholder.typicode.com/posts
// 请求体：
{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

如何添加请求头

请求头可以包含多个关键信息，如Content-Type、Authorization等。在Postman中添加请求头的步骤如下：

1. 点击“Headers”标签页。
2. 在“Key”和“Value”输入框中分别输入请求头的键和值。
3. 点击“Add”按钮添加请求头。

示例代码

// 添加请求头
// 请求头键：Content-Type
// 请求头值：application/json

// 添加请求头
// 请求头键：Authorization
// 请求头值：Bearer your_token

响应结果的解读

响应结果由Postman自动解析，包含了响应头和响应体两部分内容。响应头包含了响应的状态码、内容类型等信息，响应体则是服务器返回的数据。

示例代码

// 响应头示例
// 状态码：200 OK
// 内容类型：application/json

// 响应体示例
[
  {
    "userId": 1,
    "title": "foo",
    "body": "bar"
  },
  {
    "userId": 2,
    "title": "bar",
    "body": "foo"
  }
]

管理与组织测试数据

使用环境变量管理数据

环境变量可以帮助你在不同的测试环境中切换。例如，你可以在开发环境和生产环境中分别使用不同的服务器地址。

1. 在左侧面板的“Environments”下点击“+”，新建环境。
2. 在新建的环境中设置相应的环境变量。
3. 在请求中使用这些环境变量。

示例代码

// 创建环境变量
// 环境名称：DEV
// 环境变量：baseURL
// 变量值：https://jsonplaceholder.typicode.com

// 使用环境变量
// 请求URL：{{baseURL}}/users

创建与编辑测试数据集合

测试数据集合（Collection）可以帮助你更好地组织和管理你的请求。在Postman中创建新的集合的步骤如下：

1. 在左侧面板的“Collections”下点击“+”，新建集合。
2. 在新建的集合中添加请求。

示例代码

// 创建集合
// 集合名称：User API Tests

// 添加请求到集合
// 请求名称：Get Users
// 请求URL：https://jsonplaceholder.typicode.com/users

// 添加请求到集合
// 请求名称：Create User
// 请求URL：https://jsonplaceholder.typicode.com/posts
// 请求体：
{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

如何编辑集合

要编辑集合中的请求，可以按照以下步骤操作：

1. 在左侧面板的“Collections”下找到集合名称。
2. 双击已有的请求名称，进入编辑界面。
3. 修改请求的设置后保存。

示例代码

// 编辑集合中的请求
// 请求名称：Get Users
// 请求URL：https://jsonplaceholder.typicode.com/users

// 修改请求URL
// 请求URL：https://newurl.com/users

使用Postman测试API

Postman允许你通过编写测试脚本来验证API的响应。

1. 在“Tests”标签页中编写测试脚本。
2. 使用JavaScript编写测试逻辑。
3. 运行请求查看测试结果。

示例代码

// 编写测试脚本
pm.test("Status code is 200", function() {
  pm.expect(pm.response.code).to.equal(200);
});

pm.test("Body contains 'foo'", function() {
  pm.expect(pm.response.json()).to.include("foo");
});

// 运行请求查看测试结果

利用Postman进行协作

如何分享你的请求与集合

你可以通过Postman的共享功能将请求和集合分享给团队成员。分享过程如下：

1. 在请求或集合详情页面，点击“Share”按钮。
2. 输入需要分享的邮箱地址。
3. 设置分享的权限（如只读、编辑等）。
4. 发送分享链接。

示例代码

// 分享请求
// 请求名称：Get Users
// 分享链接：https://app.getpostman.com/run/123456789

// 分享集合
// 集合名称：User API Tests
// 分享链接：https://app.getpostman.com/collection/987654321

使用Postman工作空间进行团队协作

Postman的工作空间（Workspace）功能可以帮助团队成员更好地协作，共享请求和集合。

1. 在Postman中创建一个新的工作空间。
2. 邀请团队成员加入工作空间。
3. 在工作空间中创建和管理请求和集合。

示例代码

// 创建工作空间
// 工作空间名称：My Team API Tests

// 邀请团队成员
// 邮箱地址：team-member1@example.com, team-member2@example.com

// 在工作空间中创建请求
// 请求名称：Get Users

// 在工作空间中创建集合
// 集合名称：User API Tests

Postman公共API市场介绍

Postman的公共API市场（Public API Market）允许用户发现和使用其他人分享的API。

1. 访问公共API市场页面 https://www.postman.com/public/api-marketplace。
2. 浏览和搜索API。
3. 选择需要使用的API，复制其请求地址。
4. 在Postman中创建新的请求，并将请求地址粘贴进去。

示例代码

// 访问公共API市场页面
// URL：https://www.postman.com/public/api-marketplace

// 浏览API
// API名称：GitHub API

// 复制请求地址
// 请求URL：https://api.github.com/users

// 创建新的请求
// 请求名称：Get GitHub Users
// 请求URL：https://api.github.com/users

通过以上步骤，你可以更好地利用Postman进行API测试和协作。希望这篇教程对你有所帮助。如果你有任何问题或建议，欢迎随时联系Postman团队或在Postman社区中寻求帮助。