引入
-
请求体(Body)是发送 HTTP 请求时的重要组成部分
-
Postman 是一款强大的 API 测试工具,支持多种请求体格式
-
开发者可以根据 API 的需求灵活设置请求体格式与数据
一、none(无请求体)
-
当请求不需要发送数据时,可以选择此选项
-
适用于不需要发送请求体的 HTTP 方法,例如,GET、DELETE、HEAD 等
二、form-data(表单数据)
1、基本介绍
-
数据以键值对(
Key-Value)的形式发送 -
支持上传文件(File 类型)
-
适用于发送表单数据,用于
multipart/form-data格式 -
常用于文件上传或同时发送文本和文件数据的场景
2、示例
| Key | Value |
|---|---|
| username | john |
| avatar | 【选择文件】 |
三、x-www-form-urlencoded
1、基本介绍
-
数据以
key=value的形式发送,多个键值对用&连接 -
数据会被 URL 编码,适用于需要编码特殊字符的场景
-
适用于发送表单数据,用于
application/x-www-form-urlencoded格式 -
常用于 HTML 表单提交的场景
2、示例
# 原始字符串
username=john&password=123456
# URL 编码字符串
username%3Djohn%26password%3D123456
四、Raw
1、基本介绍
-
需要指定数据类型,例如,JSON、XML、Text 等
-
可以手动输入或粘贴数据
-
适用于发送任意格式的原始数据
2、支持的子类型
(1)Text(纯文本数据)
-
数据以纯文本形式发送,无需任何特殊格式
-
适用于发送简单的纯文本数据
-
常用于发送非结构化文本或自定义格式的数据
(2)JavaScript(JavaScript 代码)
-
输入 JavaScript 代码,Postman 会将其作为请求体发送
-
通常用于测试或动态生成数据的场景
(3)JSON(JSON 格式的数据)
-
JSON 是一种轻量级的数据交换格式,易于阅读和编写
-
数据以键值对的形式组织,支持嵌套结构
-
常用于 RESTful API 的请求体
(4)HTML(HTML 代码)
-
输入 HTML 代码,Postman 会将其作为请求体发送
-
常用于测试 HTML 内容的场景
(5)XML(XML 格式的数据)
-
XML 是一种可扩展的标记语言,数据以标签的形式组织
-
支持嵌套结构和属性
-
常用于 SOAP API 或其他基于 XML 的 API
2、示例
- Text(纯文本数据)
plain text message
- JavaScript(JavaScript 代码)
const data = {
username: "john",
password: "123456"
};
- JSON(JSON 格式的数据)
{
"username": "john",
"password": "123456"
}
- HTML(HTML 代码)
<h1>Hello, World!</h1>
<p>This is HTML message</p>
- XML(XML 格式的数据)
<user>
<username>john</username>
<password>123456</password>
</user>
五、Binary(二进制数据)
-
通过文件选择器上传二进制文件
-
适用于需要直接发送文件内容的场景
-
适用于上传二进制文件,例如,图片、音频、视频等
六、GraphQL
1、基本介绍
-
输入 GraphQL 查询语句
-
可以定义查询变量(Query Variables)
-
适用于发送 GraphQL 查询请求
2、示例
query {
user(id: 1) {
name
email
}
}