Postman入门：新手必备教程

本文将详细介绍Postman的下载安装、基本操作以及环境管理等关键内容，帮助读者快速掌握Postman入门知识，高效进行API测试和调试。无论是开发者还是测试人员，都能从Postman入门中受益匪浅。

Postman是一款功能强大的API开发工具，它可以帮助开发者和测试人员高效地测试、调试和文档化Web API。Postman提供了从发送单一HTTP请求到构建完整API测试套件的全面功能。支持GET、POST、PUT、DELETE等多种HTTP方法，可以设置请求头、参数、响应断言等。

此外，Postman还提供了环境管理、集合管理、监视器等功能，方便用户管理和维护大量的API测试用例。支持自动化脚本，帮助用户编写复杂的测试脚本，提高测试效率。同时，Postman也是一个很好的协作工具，团队成员可以共享测试环境、测试用例和测试结果。

访问Postman官方网站（https://www.postman.com/downloads/）下载适合你的操作系统的最新版本。当前支持的操作系统包括Windows、macOS、Linux和Chrome浏览器插件。以下是Windows和macOS系统的安装步骤：

Windows安装步骤

1. 访问Postman官方网站，下载Windows版本的安装包。
2. 运行下载后的安装包，按照提示完成安装。
3. 安装完成后打开Postman应用程序，点击“同意”开始使用。

macOS安装步骤

1. 访问Postman官方网站，下载macOS版本的安装包。
2. 使用Finder打开下载的安装包，将Postman应用程序拖动到你的Applications文件夹。
3. 安装完成后打开Postman应用程序，点击“同意”开始使用。

打开Postman后，你会看到一个类似图示的界面。以下是界面中各个部分的介绍：

• 导航栏：包含“主页”、“集合”、“监控器”、“工作区”等选项，用于浏览和管理不同的内容。
• 请求栏：包含“请求名称”、“请求类型（GET、POST等）”、“URL”、“发送按钮”等，用于输入和发送请求。
• 请求详情：显示请求的详细信息，包括请求头、参数、正文、预请求脚本、测试脚本等。
• 响应预览：显示请求的响应信息，包括响应头、响应体、响应时间等。
• 环境和集合：显示当前使用的环境和集合。

Postman中的每个请求都是通过创建一个请求对象来实现的，一个请求对象包含请求的URL、HTTP方法、请求头、请求参数、请求体以及相应的测试脚本。创建请求的方法如下：

1. 在Postman中，点击左侧面板中的“新建”按钮，选择“请求”。
2. 输入请求的URL，例如https://jsonplaceholder.typicode.com/posts/1。
3. 选择请求的方法，例如GET、POST、PUT等。
4. 可以在“Headers”标签页中添加请求头，例如设置Content-Type为application/json。
5. 可以在“Params”标签页中添加请求参数，例如id=1。
6. 可以在“Body”标签页中添加请求体，例如JSON格式的数据。
7. 点击“发送”按钮发送请求。

示例代码

{
    "id": 1,
    "title": "The Title",
    "body": "The Body",
    "userId": 1
}

Postman支持多种HTTP方法，常用的有GET、POST、PUT、DELETE等。每种方法具有不同的用途：

• GET方法：用于请求资源的一种标准方法，通常用于向服务器请求数据，例如读取一个用户的详细信息。
• POST方法：用于请求服务器创建新资源，通常用于向服务器提交表单数据，例如提交一个新用户的信息。
• PUT方法：用于请求服务器更新资源，通常用于更新一个已存在的资源的数据。
• DELETE方法：用于请求服务器删除资源，通常用于删除一个资源。

示例代码

请求一个用户信息：

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

提交一个新用户的信息：

POST https://jsonplaceholder.typicode.com/users
Content-Type: application/json

{
    "name": "Jane Doe",
    "username": "janedoe",
    "email": "janedoe@example.com",
    "address": {
        "street": "21 Wallaby Way",
        "suite": "Apt. 6",
        "city": "Sydney",
        "zipcode": "2000",
        "geo": {
            "lat": "-37.3159",
            "lng": "145.1331"
        }
    },
    "phone": "1324567890",
    "website": "janedoe.com",
    "company": {
        "name": "ACME Corp",
        "catchPhrase": "Innovative solutions for your business",
        "bs": "Transforming the future"
    }
}

更新一个用户的地址信息：

PUT https://jsonplaceholder.typicode.com/users/1
Content-Type: application/json

{
    "address": {
        "street": "22 Wallaby Way",
        "suite": "Apt. 7",
        "city": "Sydney",
        "zipcode": "2000",
        "geo": {
            "lat": "-37.3159",
            "lng": "145.1331"
        }
    }
}

删除一个用户信息：

DELETE https://jsonplaceholder.typicode.com/users/1

在发送请求之前，你可能需要设置一些请求头和请求参数。这些设置可以帮助你更好地控制请求的行为，例如设置Content-Type、Authorization等。

设置请求头

1. 在请求详情面板的“Headers”标签页中，点击“添加头”按钮。
2. 输入请求头的名称，例如Content-Type。
3. 输入请求头的值，例如application/json。
4. 点击“保存”。

设置请求参数

1. 在请求详情面板的“Params”标签页中，点击“添加参数”按钮。
2. 输入参数的名称，例如id。
3. 输入参数的值，例如1。
4. 点击“保存”。

GET https://jsonplaceholder.typicode.com/users/1
Content-Type: application/json

id=1

Postman集合可以包含多个请求，这些请求可以组织在一起，方便管理和测试。通过创建和导入集合，你可以将一组相关的请求进行组织，便于协作和复用。

创建集合

1. 在左侧面板中，点击“新建”按钮，选择“集合”。
2. 输入集合的名称，例如Todo API。
3. 点击“创建”。

导入集合

1. 在左侧面板中，点击“导入”按钮，选择“导入集合”。
2. 选择本地文件或粘贴集合JSON代码。
3. 点击“导入”。

示例代码

{
    "id": 1,
    "name": "Todo API",
    "description": "A collection of requests for testing the Todo API",
    "requests": [
        {
            "id": 1,
            "name": "Get todo list",
            "url": "https://jsonplaceholder.typicode.com/todos",
            "method": "GET",
            "headers": [],
            "params": [],
            "body": {}
        },
        {
            "id": 2,
            "name": "Create new todo",
            "url": "https://jsonplaceholder.typicode.com/todos",
            "method": "POST",
            "headers": [],
            "params": [],
            "body": {
                "raw": "{\n  \"title\": \"Buy groceries\",\n  \"completed\": false\n}"
            }
        }
    ]
}

Postman环境变量提供了一种在多个请求中复用全局变量的机制，帮助你保持一致性，也能方便地在不同环境中进行测试。

创建环境变量

1. 在左侧面板中，点击“环境”按钮，选择“新建环境”。
2. 输入环境的名称，例如Development。
3. 输入环境变量的名称和值，例如baseUrl=https://api.dev.example.com。
4. 点击“保存”。

激活环境

在左侧面板的“环境”按钮中，选择你创建的环境变量，将它设置为当前环境。

示例代码

{
    "id": 1,
    "name": "Development",
    "values": [
        {
            "key": "baseUrl",
            "value": "https://api.dev.example.com"
        }
    ]
}

使用环境变量的示例

GET {baseUrl}/todos

通过环境设置，你可以轻松在不同的环境中切换，如开发环境、测试环境和生产环境。这样，在测试不同的环境时，你可以复用相同的测试用例和请求参数。

创建多个环境

按照上述“创建环境变量”的步骤，分别创建Development、Testing和Production三个环境。

切换环境

在左侧面板的“环境”按钮中，选择不同的环境变量，切换到不同的环境。

示例代码

{
    "id": 2,
    "name": "Testing",
    "values": [
        {
            "key": "baseUrl",
            "value": "https://api.testing.example.com"
        }
    ]
}
{
    "id": 3,
    "name": "Production",
    "values": [
        {
            "key": "baseUrl",
            "value": "https://api.example.com"
        }
    ]
}

Postman支持使用JavaScript作为测试脚本语言，你可以在请求的“Tests”标签页中编写测试脚本，来验证请求的响应。

示例代码

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

pm.test("Content-Type is JSON", function () {
    pm.response.to.have.header("Content-Type", "application/json");
});

// 获取响应体
let response = pm.response.json();
pm.test("Response has a key", function () {
    pm.expect(response).to.have.all.keys("id", "title", "body", "userId");
});

断言是测试脚本的核心部分，用于验证请求的响应是否符合预期。通过编写断言，你可以检查响应的状态码、响应头、响应体等。

示例代码

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

pm.test("Response has key 'id'", function () {
    pm.expect(pm.response.json()).to.have.property("id");
});

前置脚本和后置脚本可以用于在发送请求前或发送请求后执行某些操作，例如设置环境变量、清理数据等。

示例代码

前置脚本：

pm.environment.set("userId", JSON.stringify({
    "id": 1,
    "name": "Jane Doe",
    "username": "janedoe",
    "email": "janedoe@example.com",
    "address": {
        "street": "21 Wallaby Way",
        "suite": "Apt. 6",
        "city": "Sydney",
        "zipcode": "2000",
        "geo": {
            "lat": "-37.3159",
            "lng": "145.1331"
        }
    },
    "phone": "1324567890",
    "website": "janedoe.com",
    "company": {
        "name": "ACME Corp",
        "catchPhrase": "Innovative solutions for your business",
        "bs": "Transforming the future"
    }
}));

后置脚本：

// 清除环境变量
pm.environment.unset("userId");

监视器功能可以帮助你定期发送请求并记录响应，这对于监控API的可用性和性能非常有帮助。

创建监视器

1. 在左侧面板中，点击“新建”按钮，选择“监视器”。
2. 输入监视器的名称，例如Daily Check。
3. 选择要监视的集合和请求。
4. 设置发送频率、发送次数和插件设置。
5. 点击“保存”。

示例代码

{
    "id": 1,
    "name": "Daily Check",
    "collectionId": "1234567890",
    "environmentId": "0987654321",
    "schedule": {
        "enabled": true,
        "interval": "Daily",
        "intervalTime": "08:00 AM"
    },
    "iterations": 3,
    "plugins": []
}

测试结果可以保存到Postman工作区中，方便团队成员查看和共享。通过共享测试结果，团队成员可以更高效地协作。

保存测试结果

1. 在请求的“Tests”标签页中，编写测试脚本。
2. 点击“发送”按钮发送请求。
3. 在“响应”面板中，点击“保存”按钮保存测试结果。

分享测试结果

1. 点击左侧面板中的“工作区”按钮。
2. 创建或选择一个现有工作区。
3. 将测试结果分享给团队成员。
4. 团队成员可以在工作区中查看和评论测试结果。

示例代码

{
    "id": 1,
    "name": "Get todo list",
    "url": "https://jsonplaceholder.typicode.com/todos",
    "method": "GET",
    "tests": [
        {
            "id": 1,
            "name": "Status code is 200",
            "script": "pm.response.to.have.status(200)"
        },
        {
            "id": 2,
            "name": "Response has a key",
            "script": "let response = pm.response.json(); pm.expect(response).to.have.all.keys('id', 'title', 'completed')"
        }
    ]
}

Postman的自动化功能可以帮助你编写复杂的测试脚本，提高测试的自动化程度。通过使用Postman的自动化功能，你可以编写脚本来模拟用户行为，验证API的功能。

创建自动化脚本

1. 在请求的“Tests”标签页中，编写测试脚本。
2. 使用Postman的内置函数和方法编写脚本，例如pm.environment.set、pm.environment.unset、pm.test等。
3. 在请求的“Pre-request Script”标签页中，编写前置脚本，用于在发送请求前执行某些操作。
4. 在请求的“Tests”标签页中，编写测试脚本，用于验证请求的响应。
5. 在请求的“Tests”标签页中，编写后置脚本，用于在发送请求后执行某些操作。

示例代码

前置脚本：

pm.environment.set("userId", 1);

测试脚本：

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

pm.test("Response has a key", function () {
    pm.expect(pm.response.json()).to.have.property("id");
});

后置脚本：

pm.environment.unset("userId");
``

通过上述配置，你可以编写复杂的测试脚本，提高测试的自动化程度。Postman提供了丰富的内置函数和方法，帮助你更方便地编写测试脚本。