阅读量:3
Linux下 Postman 设置接口请求体的实用指南
一 基本设置步骤
- 在 Linux 中安装并启动 Postman(下载 Linux 版本压缩包、解压至 /opt、创建软链,如
sudo ln -s /opt/Postman/Postman /usr/local/bin/postman,终端执行postman启动)。 - 新建请求:选择 POST/PUT/PATCH 等方法,输入 URL。
- 打开 Body 选项卡,根据接口要求选择一种 Body 类型 并填写数据。
- 如未自动设置,手动在 Headers 添加 Content-Type(例如:application/json 或 application/x-www-form-urlencoded)。
- 点击 Send 发送,并在下方 Response 区域查看状态码、响应头和响应体。
- 需要复用与组织请求时,保存到 Collections,并使用 Environments 管理变量(如
{{base_url}})。
二 常见 Body 类型与配置要点
| 类型 | 适用场景 | 关键设置 | 示例 |
|---|---|---|---|
| raw – JSON | 创建/更新资源、RESTful 接口 | Body → raw → JSON;确保 Content-Type: application/json | { "name": "Alice", "age": 30 } |
| x-www-form-urlencoded | 传统表单提交、登录等 | Body → x-www-form-urlencoded;Postman 会自动设置 Content-Type | key: username,value: test |
| form-data | 文件上传、混合字段 | Body → form-data;可添加文本字段与文件字段 | file: 选择文件;desc: “upload” |
| binary | 纯二进制数据(如图片、PDF) | Body → binary;选择文件 | 选择 avatar.png |
- 说明:GET/DELETE 通常不带请求体;JSON 最常用且需保证 JSON 有效 与 Content-Type 正确。
三 常见后端场景与 Postman 配置对照
| 后端接收方式 | Postman 设置 | 注意点 |
|---|---|---|
| @RequestBody Map |
Body → raw → JSON;Header 加 application/json | 不能用 Params 传;确保 JSON 语法正确 |
表单参数(如 application/x-www-form-urlencoded) |
Body → x-www-form-urlencoded | 使用键值对;Postman 会自动设置 Content-Type |
文件上传(如 multipart/form-data) |
Body → form-data,添加文件字段 | 选择文件;可同时添加文本描述字段 |
- 提示:后端若用 @RequestBody 接收,请在 Postman 中使用 JSON 请求体,而非查询参数或表单键值对。
四 命令行与自动化运行 Newman
- 安装 Newman(Postman 命令行工具):
npm install -g newman。 - 在 Postman 中将集合 Export 为 JSON 文件(如
collection.json)。 - 在 Linux 终端运行:
newman run collection.json,可在 CI/CD 或服务器上批量执行接口请求与测试。
五 排错清单
- 出现 415 Unsupported Media Type:检查 Content-Type 是否与 Body 类型匹配(JSON →
application/json,表单 →application/x-www-form-urlencoded)。 - 出现 400/422 或后端无法解析:确认 JSON 有效、字段名与类型正确;使用 raw – JSON 发送结构化数据。
- 文件上传失败:改用 form-data 并正确选择文件字段。
- 接口需要鉴权:在 Headers 添加 Authorization: Bearer
或使用环境变量管理令牌。
以上就是关于“Linux Postman如何进行接口请求体设置”的相关介绍,筋斗云是国内较早的云主机应用的服务商,拥有10余年行业经验,提供丰富的云服务器、租用服务器等相关产品服务。云服务器资源弹性伸缩,主机vCPU、内存性能强悍、超高I/O速度、故障秒级恢复;电子化备案,提交快速,专业团队7×24小时服务支持!
简单好用、高性价比云服务器租用链接:https://www.jindouyun.cn/product/cvm