在 Ubuntu 上通过 Postman 调用 RESTful API 的完整步骤
一 安装 Postman
- 推荐方式：使用 Snap 安装（稳定、自动更新）
- 更新索引并安装 Snap（如未安装）：sudo apt update && sudo apt install snapd
- 安装 Postman：sudo snap install postman
- 启动：在应用菜单搜索 Postman 或终端执行 postman
- 备选方式：下载 Linux 64 位包解压到 /opt 并创建启动器
- 下载：wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
- 解压：sudo tar -xzf postman.tar.gz -C /opt
- 软链：sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
- 桌面入口（可选）：创建 /usr/share/applications/postman.desktop，内容示例：
[Desktop Entry]
Encoding=UTF-8
Name=Postman
Exec=/usr/local/bin/postman
Icon=/opt/Postman/app/resources/app/assets/icon.png
Terminal=false
Type=Application
Categories=Development;
- 常见问题
- 若启动时报错缺少库（如：libgconf-2.so.4），安装依赖：sudo apt install libgconf2-4
- 不建议使用 sudo 启动 Postman，避免产生文件权限问题
二 发送第一个请求
- 新建请求：点击左上角 + 或 New → Request，命名并保存到集合（Collection）
- 选择方法：如 GET
- 输入 URL：例如 https://reqres.in/api/users
- 发送：点击 Send，在下方查看状态码、响应时间、响应头和响应体（JSON 可格式化查看）
- 说明：上述示例为公开的测试接口，适合快速验证环境是否可用
三 常用请求与配置
- 常用方法：GET/POST/PUT/PATCH/DELETE
- 请求头 Headers：如 Content-Type: application/json
- 请求体 Body：
- raw → JSON：适合提交结构化数据
- form-data / x-www-form-urlencoded：适合表单或文件上传
- 查询参数 Params：在 Params 选项卡添加键值对，自动拼接到 URL
- 认证：在 Authorization 选项卡选择类型（如 Bearer Token、Basic Auth），填入凭据
四 断言测试与自动化
- Tests 选项卡：使用 JavaScript 编写断言，示例
pm.test(“Status code is 200”, () => pm.response.to.have.status(200));
pm.test(“Response has userId”, () => {
const jsonData = pm.response.json();
pm.expect(jsonData).to.have.property(‘userId’);
});
- 集合与运行：将相关请求保存为 Collection，可使用 Collection Runner 批量运行、数据驱动测试
- 环境变量与全局变量：在 Manage Environments 中创建环境（如 Development），定义变量（如 {{base_url}}、{{api_key}}），在请求中以 {{变量名}} 引用，便于多环境切换
- 命令行运行：使用 Newman（Postman CLI）在 CI/CD 中执行集合
- 安装：npm install -g newman
- 运行：newman run <collection.json> [–environment <env.json>]
五 网络与代理设置
- 代理配置：在 Postman 右上角齿轮图标 → Settings → General → Proxy，按需配置 HTTP/HTTPS 代理地址与端口；如代理需要认证，启用 Proxy authentication 并填写用户名与密码
- 企业网络：若公司网络存在拦截或需要上游代理，请与网络管理员确认代理地址与认证方式，并在 Postman 中正确配置以避免请求失败