【学习记录】Python Requests 库中 data 与 json 参数的区别详解

在使用 Python 的 Requests 库发送 HTTP 请求时， data 和 json 是两个常用的参数，用于向服务器提交请求体数据。虽然它们都能完成“发送数据”的任务，但在底层实现和使用场景上存在明显差异。本文将详细解析两者的区别，并提供实际应用建议。

---

🧾 1. data 参数：发送表单数据（application/x-www-form-urlencoded）

🔹 使用场景：

适用于模拟 HTML 表单提交，如登录、注册等传统 Web 接口。

🔹 示例代码：

import requests

url = 'http://example.com/api'
payload = {'key1': 'value1', 'key2': 'value2'}

response = requests.post(url, data=payload)
print(response.text)

🔹 特点：

• 数据以 application/x-www-form-urlencoded 格式编码；
• 支持字典、元组、字符串等多种格式；
• 默认不自动设置 Content-Type，需要手动指定（某些 API 可能依赖此头）；
• 不会自动序列化为 JSON。

---

🧾 2. json 参数：发送 JSON 数据（application/json）

🔹 使用场景：

适用于与现代 RESTful API 交互，尤其是前后端分离架构或微服务通信。

🔹 示例代码：

import requests

url = 'http://example.com/api'
payload = {'key1': 'value1', 'key2': 'value2'}

response = requests.post(url, json=payload)
print(response.text)

🔹 特点：

• 自动将字典转换为 JSON 格式；
• 自动设置 Content-Type 为 application/json；
• 更加简洁、安全，避免手动处理 JSON 编码问题；
• 若传入非字典类型，也会尝试将其序列化。

---

⚖️ 3. 如何选择？

场景	推荐参数	内容类型
提交 HTML 表单	data	application/x-www-form-urlencoded
调用 RESTful API	json	application/json

📌 如果你不确定目标接口期望的数据格式，可以查看文档说明，或者通过抓包工具（如 Postman 或 Wireshark）分析请求头中的 Content-Type 字段。

---

✅ 总结

对比项	data	json
数据格式	表单编码	JSON
是否自动序列化	否	是
Content-Type 设置	需手动设置	自动设置为 application/json
适用场景	传统 Web 表单	RESTful API

合理使用 data 与 json 参数，不仅能提高开发效率，还能确保与后端服务的正确通信。理解其区别是每个 Python 开发者必备的技能之一。

---

📌 如果你对网络请求技术感兴趣，或者正在python相关知识，这篇文章可以帮助你了解 Python Requests 的使用方法。

💬 欢迎留言交流你在项目中使用这些技术的经验，或者你遇到的相关问题，我们一起探讨python技术的发展与实践！