Difference between data and json parameters in Python Requests package

在使用 Python 的 Requests 库时，data 和 json 是两个用于指定在请求体（body）中发送的数据的参数，但它们在使用和数据处理方式上有所不同。

使用 data 参数

data 参数可以发送表单数据和非 JSON 数据。最常见的用途是发送表单数据。当使用 data 参数时，它可以接受字典、字节序列或文件对象。如果传入字典，Requests 会默认使用 application/x-www-form-urlencoded 的内容类型（Content-Type），将字典转换为查询字符串格式（key1=value1&key2=value2）。

例如，发送表单数据：

python
import requests

url = 'http://httpbin.org/post'
payload = {'key1': 'value1', 'key2': 'value2'}
response = requests.post(url, data=payload)
print(response.text)

这将发送一个 POST 请求，其中表单数据 key1=value1&key2=value2 被编码并包含在请求体中。

使用 json 参数

json 参数用于直接发送 JSON 格式的数据。当使用 json 参数时，Requests 会自动将你的数据序列化为 JSON 字符串，同时设置请求头（Headers）的 Content-Type 为 application/json。这使得发送 JSON 数据变得异常简单和直观。

例如，发送 JSON 数据：

python
import requests

url = 'http://httpbin.org/post'
payload = {'key1': 'value1', 'key2': 'value2'}
response = requests.post(url, json=payload)
print(response.text)

在这个例子中，payload 字典被自动转换成了 JSON 字符串 {"key1": "value1", "key2": "value2"} 并发送到服务器，同时Content-Type 被设置为 application/json。

总结

简而言之，选择 data 或 json 主要取决于服务器端期望接收什么格式的数据。如果服务器期望的是表单编码的数据，应该使用 data；如果服务器期望的是 JSON 编码的数据，应该使用 json。正确地使用这些参数可以确保数据以正确的格式发送，同时也有助于避免请求相关的错误。