📦 一、Postman 简介
Postman 是一款免费的 API 开发协作工具,支持接口测试、自动化脚本、Mock Server 和 API 文档生成等功能。它跨平台支持 Windows、macOS 和 Linux,并且还有网页版和浏览器插件。
🛠️ 二、Postman 安装与配置
1. 下载与安装
-
官网地址:Postman: The World's Leading API Platform | Sign Up for Free
-
根据操作系统下载对应安装包,安装完成后注册账户即可使用。
2. 简单配置
-
登录账户后,可以同步个人工作区和团队协作数据。
-
设置代理:在 Settings > Proxy 配置公司或本地代理。
📝 三、Postman 基础用法
1. 发送 GET 请求
-
打开 Postman,新建请求,选择 GET 方法。
-
输入接口地址,例如:
arduino
复制编辑
https://jsonplaceholder.typicode.com/posts
-
点击 Send 按钮,查看返回结果。
返回示例:
json
复制编辑
[ { "userId": 1, "id": 1, "title": "sunt aut facere repellat provident occaecati", "body": "quia et suscipit suscipit recusandae" }, ... ]
2. 发送 POST 请求
-
选择 POST 方法。
-
在 Body 栏选择 raw 格式,并选择
JSON
类型。 -
输入请求数据:
json
复制编辑
{ "title": "优快云 教程", "body": "这是一篇 API 调试教学文章", "userId": 1 }
-
点击 Send,查看服务器返回值。
3. 设置请求头
在 Headers 标签中添加:
Key | Value |
---|---|
Content-Type | application/json |
Authorization | Bearer <token> |
🌟 四、Postman 高级功能
1. 环境变量管理
-
在 Postman 中创建环境变量,比如:
ini
复制编辑
baseUrl = https://api.example.com
-
请求地址可写成:
bash
复制编辑
{{baseUrl}}/users
2. 编写 Pre-request Script
在请求前自动执行脚本,例如生成动态 Token:
javascript
复制编辑
pm.environment.set("token", "Bearer " + generateToken());
3. 编写测试脚本
在 Tests 标签中添加断言:
javascript
复制编辑
pm.test("状态码为 200", function () { pm.response.to.have.status(200); }); pm.test("响应包含字段 title", function () { pm.response.to.have.jsonBody('title'); });
4. 使用 Mock Server
Postman 支持一键生成 Mock Server:
-
点击 Mock Server > Create a Mock Server
-
配置响应数据,进行前端独立调试。
🚀 五、实战案例:调试用户登录接口
接口说明
arduino
复制编辑
POST https://api.example.com/login Body: { "username": "testuser", "password": "123456" }
1. 配置请求
-
方法:POST
-
Headers:
-
pgsql
-
复制编辑
Content-Type: application/json
-
Body:
zjjxhs.com
uniform888.com
nf138.com
gzgaw.com
yxhgj.com
tjlawan.com
asicr.com
zaoyangbbs.com
zhiboxing.com
linchangwei.cn
zhengchengweishuo.com
cdstpzx.com
lyws.com.cn
niangrui.com
hl-bf.net
ravoco.net
tzmsw.net
gaofeiya.com.cn
checkedout.com.cn
fzhbw.com.cn
json
复制编辑
{ "username": "testuser", "password": "123456" }
2. 编写测试脚本
验证登录成功返回 Token:
javascript
复制编辑
pm.test("登录成功返回 200", function () { pm.response.to.have.status(200); }); pm.test("响应体包含 token", function () { var jsonData = pm.response.json(); pm.expect(jsonData).to.have.property("token"); });
3. 使用 Collection Runner 批量测试
-
将所有接口请求加入一个 Collection。
-
点击 Runner,批量执行接口测试。
🛡️ 六、常见问题排查
问题 | 解决方法 |
---|---|
请求超时 | 检查接口地址、网络或代理设置 |
返回 401 Unauthorized | 确认 Authorization Header 是否正确 |
无法同步数据 | 检查是否登录账户,确认网络是否可访问 |
🌿 七、高效技巧
✅ 生成 API 文档
-
在 Collection 中点击 View Docs,可生成在线 API 文档。
✅ 一键导出代码
-
点击 Code 按钮,可生成 cURL、JavaScript、Python 等语言代码。
✅ 快捷键
操作 | 快捷键 |
---|---|
发送请求 | Ctrl + Enter |
新建请求 | Ctrl + N |
切换标签 | Ctrl + Tab |