文档首页> 云计算> 蓝易云：Postman04-Post方法发送请求

蓝易云：Postman04-Post方法发送请求

发布时间：2025-12-19 00:04       

在 Postman 里用 POST 方法发送请求，本质上是把“业务数据”以约定格式写进 Request Body，再配齐 Headers / Auth，让服务端能正确解析并返回结果。下面按“可落地、少踩坑”的路径走一遍。

1）创建 POST 请求：先把“入口”打通

  1. 新建一个 Request（建议放进 Collection，便于复用环境变量与鉴权）。
  2. Method 选择 POST。
  3. 填写 URL：
    • 建议用变量：{{baseUrl}}/api/v1/order/create（后面环境切换更丝滑）。

2）Params vs Body：别把“查询参数”塞进“请求体”

  • Params（Query String）：URL 后面的 ?a=1&b=2，多用于过滤、分页、开关类参数。
  • Body（请求体）：POST 的核心载荷（创建、提交、写入类数据）。
    Postman 允许你同时带 Params 和 Body，但要清楚每个字段该去哪，避免“看起来发了，服务端却收不到”。(Postman Docs)

3）Headers：最常见的成败开关

在 Headers 里重点关注三类：

  • Content-Type：告诉服务端你 Body 的格式（JSON/表单/文件等）。
  • Accept：告诉服务端你期望的返回格式（常见 application/json）。
  • Authorization 或自定义鉴权头（如 X-API-Key）。

Postman 在你配置时会提供常见 Header 的提示与自动补全，减少手误成本。(Postman Docs)

4）Body 选型：选错格式，接口会“装聋作哑”

进入 Body，你会看到常见三种主流模式（再加一个文件上传）：

A. raw（推荐：JSON 接口首选）

  • 选择 raw，右侧下拉选 JSON。
  • Postman 会启用语法高亮，并倾向于自动带上匹配的 Content-Type；如需覆盖也可以手动改。(Postman Docs)

示例（raw JSON）：

{
  "userId": 10001,
  "amount": 99.9,
  "channel": "card"
}
​

B. x-www-form-urlencoded（传统表单接口常用）

  • 适合 key=value&key2=value2 这类编码表单。
  • Postman 会对 key/value 做 URL 编码；服务端通常按表单解析。(Baeldung on Kotlin)

C. form-data（multipart/form-data，带文件/混合字段）

  • 既能传文本字段，也能传文件（File 类型）。
  • 常用于上传图片、证书、附件等。

D. binary（纯文件流）

  • 直接把整个 Body 当文件流发送，适合少数“只收文件”的接口。

一句直白的判断：服务端只会按它“支持的 Content-Type”去解析。你把 JSON 发给只吃表单的接口，它就会像“只吃米饭却端上意面”的人一样：能看见，但不动筷。

5）鉴权：别在 401 上反复内耗

优先用 Authorization 标签页配置（而不是手打头部），原因很简单：Postman 会按你选的鉴权类型自动填充到请求的正确位置，并支持变量化管理。(Postman Docs)
常见选择：

  • Bearer Token（最常见）
  • Basic Auth
  • API Key
  • OAuth 2.0（按接口要求配置）

6）环境变量：把“可变项”产品化

建议至少抽这几类变量：

  • baseUrl：测试/预发/生产切换
  • token：鉴权令牌
  • tenantId / appId：多租户或多应用场景

Postman 的环境变量可在多请求之间复用，也能在脚本里动态更新。(Postman Docs)

7）排错清单：把问题一次定位到位

  • 415 Unsupported Media Type：多半是 Content-Type 与 Body 不匹配（JSON/表单选错）。
  • 400 Bad Request：字段缺失、类型不对、JSON 不合法、编码问题。
  • 401/403：鉴权没带、token 过期、权限不足（优先检查 Authorization）。
  • 请求卡在 TLS/证书：
    • 可在请求的 Settings 中关闭 SSL 证书校验进行验证（仅用于排查与受控环境）。(Postman Docs)

8）一张对照表：选 Body 不纠结（建议收藏）

如果你愿意再“进阶一步”，下一阶段我建议你把 Pre-request Script + Tests 用起来：把 token 自动刷新、把响应字段自动写进环境变量，这样你调接口会从“手工操作”升级成“可复用的自动化资产”。