Debian Postman如何进行API接口调用

在 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} } ）

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！