Postman 使用指南：从入门到接口联调

前言

当你开始接触后端接口或者做客户端开发时，一定会遇到一个问题：

接口到底通不通？

这时候就需要一个工具来“脱离代码直接测试接口”，
而这个工具就是：

Postman

什么是 Postman？

Postman 是一个用于测试 API 接口的工具。

你可以把它理解为：

一个专门用来发送网络请求的调试工具

为什么要用 Postman？

在没有 Postman 时，你可能会：

• 写 Unity 代码去调接口
• 写前端代码去测试
• 一出错就不知道是代码问题还是接口问题

有了 Postman：

• 不用写代码就能测试接口
• 可以快速验证接口是否正常
• 可以定位问题在哪一层

核心功能

Postman 可以：

• 发送 GET / POST / PUT / DELETE 请求
• 设置请求参数（Params）
• 设置请求头（Headers）
• 设置请求体（Body）
• 查看返回数据
• 查看状态码
• 保存接口集合

界面结构说明

Postman 的核心界面主要包含：

1️⃣ 请求方式

选择 GET / POST 等

2️⃣ URL

接口地址

3️⃣ Params

地址参数（拼在 URL 后）

4️⃣ Headers

请求头信息

5️⃣ Body

请求体（POST 常用）

6️⃣ Response

服务器返回结果

基本使用流程

示例：GET 请求

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

操作步骤：

1. 选择 GET
2. 输入 URL
3. 点击 Send
4. 查看返回结果

示例：POST 请求

POST https://example.com/login

Body：

{
  "username": "test",
  "password": "123456"
}

操作步骤：

1. 选择 POST
2. 填写 URL
3. 打开 Body → 选择 raw → JSON
4. 输入请求体
5. 点击 Send

重要概念

Params

URL 参数：

/api/player?id=1

Headers

请求头：

Content-Type: application/json
Authorization: Bearer token

Body

请求体：

{
  "name": "Hero"
}

Status Code

和 Swagger 的配合

推荐流程：

1. 用 Swagger 查看接口文档
2. 用 Postman 测接口
3. 再写 Unity 请求代码

在 Unity 开发中的实际作用

使用 Postman 可以帮助你：

• 确认接口是否正常
• 验证参数是否正确
• 查看真实返回数据
• 减少调试成本

常见使用场景

• 登录接口调试
• 获取数据接口测试
• 上传接口测试
• Token 验证
• 联调排错

常见问题

1. 请求失败

检查：

• URL 是否正确
• 请求方式是否正确
• 参数是否完整

2. 返回 401

说明需要认证（Token）

3. 返回数据不对

检查：

• Body 格式
• Content-Type
• 字段名

使用建议

• 先用 Postman 测通接口
• 再写 Unity 代码
• 保存常用接口为 Collection
• 使用环境变量管理 URL / Token

一句话总结

Postman = 用来测试接口的调试工具

后续学习

• UnityWebRequest 请求封装
• JSON 数据解析
• 接口错误处理
• 网络层设计

结尾

当你开始做接口开发时，Postman 就像你的“探测器”。

它不会帮你写代码，
但会帮你确认方向是否正确。