在 Debian 上使用 Postman 进行 API 调用的完整步骤
一 安装与启动
- 方式一 Snap（推荐）
- 安装 Snapd（如未安装）：sudo apt update && sudo apt install -y snapd
- 安装 Postman：sudo snap install postman --classic
- 启动：在应用菜单搜索“Postman”，或终端执行：snap run postman
- 方式二 官方 Linux 包（Tarball）
- 从官网下载 Linux 64 位包：wget https://www.postman.com/downloads/postman-linux-x64-latest.tar.gz
- 解压：tar -xzf Postman-linux-x64-*.tar.gz -C /opt
- 创建软链：sudo ln -sfn /opt/Postman/Postman /usr/local/bin/postman
- 创建桌面启动器（可选）：
- nano ~/.local/share/applications/Postman.desktop
- 写入：
[Desktop Entry]
Encoding=UTF-8
Name=Postman
Exec=/opt/Postman/Postman
Icon=/opt/Postman/app/resources/app/assets/icon.png
Terminal=false
Type=Application
Categories=Development;Code;
- 赋权：chmod +x ~/.local/share/applications/Postman.desktop
- 启动：应用菜单搜索“Postman”或执行 postman
二 发送第一个请求
- 新建请求：点击左上角 New > HTTP Request
- 选择方法：在下拉框选择 GET/POST/PUT/DELETE 等
- 输入 URL：填写完整地址（含协议、域名、路径、查询参数），如：https://api.example.com/v1/users
- 添加请求头（Headers）：常用 Content-Type: application/json、Authorization: Bearer
- 设置请求体（Body，POST/PUT 常用）：
- 选择 raw，格式选 JSON，示例：
{
“name”: “Alice”,
“email”: “alice@example.com”
}
- 发送与查看：点击 Send，在下方面板查看 Status（状态码）、Time（耗时）、Response（响应体/响应头）
三 常用功能与高效实践
- 环境变量与全局变量
- 在左侧 Environments 创建环境（如 dev/test/prod），定义变量如 base_url、token
- 请求中使用：GET {{base_url}}/users，Authorization: Bearer {{token}}
- 便于在不同环境间一键切换
- 集合与自动化
- 将相关接口放入 Collection，可批量运行、顺序执行
- 在 Tests 中编写断言，如：
pm.test(“Status is 200”, () => pm.response.to.have.status(200));
pm.test(“Response has users array”, () => {
const json = pm.response.json();
pm.expect(json).to.have.property(‘users’).that.is.an(‘array’);
});
- 可视化展示
- 在 Tests 使用 Visualizer 自定义响应展示，如生成表格：
const tpl =
<table>{{#each results}}<tr><td>{{title}}</td><td>{{release_date}}</td></tr>{{/each}}</table>;
pm.visualizer.set(tpl, pm.response.json());
- 监控与报告
- 可为集合配置 Monitor，定时运行并发送结果报告，便于持续验证接口可用性
四 实战示例
- 示例一 公共接口（无需鉴权）
- 新建请求：GET https://jsonplaceholder.typicode.com/posts/1
- 点击 Send，应返回状态码 200 与一篇帖子数据
- 示例二 需要 Bearer Token 的接口
- 新建环境：dev，添加变量：base_url=https://api.example.com/v1，token=YOUR_TOKEN
- 新建请求：GET {{base_url}}/profile
- Headers：Authorization: Bearer {{token}}
- 发送并检查响应
- 示例三 创建资源（JSON）
- 新建请求：POST {{base_url}}/users
- Headers：Content-Type: application/json
- Body raw JSON：
{
“name”: “Bob”,
“email”: “bob@example.com”
}
- 发送并验证返回状态码与返回体字段
五 常见问题与排错
- 证书/HTTPS 错误：确认系统时间正确；必要时在 Postman 设置中关闭 SSL 验证仅用于排查（生产不建议）
- 401/403：检查 Authorization 头是否正确、Token 是否过期、是否放在正确位置（Headers vs Query）
- 404：核对 URL 路径 与 HTTP 方法 是否与文档一致
- 415/400：确认 Content-Type 与 Body 格式匹配（JSON 用 raw+JSON）
- CORS（仅浏览器前端会受限）：Postman 不受浏览器 CORS 限制，服务端需正确返回 CORS 头
- 环境变量未生效：确认已选中正确的 Environment，变量名拼写无误（如 {{base_url}}）