Postman参数介绍

Params 查询参数

Params 请求url信息，会补充请求的url

在 Postman 中处理查询参数（Query Parameters）

查询参数以键值对形式附加于 URL 末端，用于调整请求结果，在 Postman 中的传递通过用户友好的界面轻松完成。

首先打开想要发送请求的请求窗口。导航至"Params"标签页，将出现键值对列表。输入参数的键和值，确保它们与所需请求行为一致。若需添加多个查询参数，重复上述步骤即可。参数设置正确后，点击"Send"按钮执行请求。

不添加时，只有默认的url

添加时，会在url后面补充

Body 请求体

有时需要通过请求体传递更复杂的数据，Postman 的"Body"标签页简化了设置不同请求体参数的过程。

仍然首先打开所需的请求窗口，并确认选择了正确的请求方法和URL路径。在"Body"标签页下，可见多种选项，如"form-data"、"raw"、"x-www-form-urlencoded"及"GraphQL"。

标签	作用	备注/示例
none	无	此请求没有正文
form-data	表单数据	添加键值对设置表单字段及其值将表单的数据组织成Key-Value形式，用分隔符boundary（boundary可任意设置）处理成一条消息。由于有boundary隔离，所以既可以上传文件，也可以上传参数。
x-www-form-urlencoded		即application/x-www-from-urlencoded，将表单内的数据转换为Key-Value
raw	文本	选定文本类型（如文本、JSON、XML 等）
binary	二进制	即Content-Type:application/octet-stream，只可以上传二进制数据，通常用来上传文件。由于没有键值，所以一次只能上传一个文件。
GraphQL

1、form-data

java 复制代码

POST  HTTP/1.1
Host: test.app.com
Cache-Control: no-cache
Postman-Token: 59227787-c438-361d-fbe1-75feeb78047e
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
 
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="filekey"; filename=""
Content-Type: 
 
 
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="textkey"
 
tttttt
------WebKitFormBoundary7MA4YWxkTrZu0gW--

2、x-www-form-urlencoded

HTTP 协议中用于表单数据传输的标准内容类型

bash 复制代码

在 HTTP 请求中的示例
POST  HTTP/1.1
Host: test.app.com
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
Postman-Token: e00dbaf5-15e8-3667-6fc5-48ee3cc89758
 
key1=value1&key2=value2
name=%E5%BC%A0%E4%B8%89&age=25&city=%E5%8C%97%E4%BA%AC

#实际解码之后的数据
name=张三
age=25
city=北京

bash 复制代码

#数据格式
键值对形式，用 = 连接，多个键值对用 & 分隔

#编码规则
使用 **URL 编码（百分号编码）**
特殊字符转为 %XX 形式（如空格 → %20）
非 ASCII 字符（如中文）使用 UTF-8 编码：中 → %E4%B8%AD

#典型应用场景
HTML 表单提交（默认的 <form> 编码类型）
API 接口调用（如滴滴接口要求）
OAuth 认证流程

核心特征

与 JSON 的对比

特性	x-www-form-urlencoded	JSON
数据结构	扁平键值对	嵌套对象/数组
数据类型	所有值都是字符串	支持多种数据类型
编码方式	URL 编码	Unicode 编码
体积效率	较低（重复键名）	较高（结构紧凑）
Content-Type 头	`application/x-www-form-urlencoded`	`application/json`

接收此类数据

java 复制代码

@PostMapping(value ="/submit", consumes = "application/x-www-form-urlencoded;charset=UTF-8")
public ResponseEntity<?> handleForm(
    @RequestParam String name,     // 自动解码
    @RequestParam int age,         // 自动类型转换
    @RequestParam String city) {
    // 处理逻辑
}

3、raw

java 复制代码

POST  HTTP/1.1
Host: test.app.com
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 05a064d2-fa79-10c0-caba-15ca5d1a940f
 
{"key1":"value1","key2":"value2"}

4、binary

java 复制代码

POST  HTTP/1.1
Host: test.app.com
Cache-Control: no-cache
Postman-Token: 5ad66f08-6faa-aba0-744a-ca958b1a0fc2
 
undefined