python - requests.post 的 `data` 和 `json` 命名参数有什么区别？

Question

根据requests library documentation的相关部分，将字典传递给 post 方法的主要方法如下:

r = requests.post(url, data = {"example": "request"})

随后，作者演示了将 JSON 字符串直接传递给 Github API 的示例。然后作者建议，不要将字典编码为 JSON 字符串并通过 data 传递，您可以简单地使用命名参数 json 传递字典，如下所示。

r= requests.post(url, json = {"example": "request"})

你什么时候会使用 json 而不是 data？这种冗余是特异的还是故意的？

Answer 1

将 dict 传递给 data 会导致 dict 被表单编码，就像您正在提交一样HTML 页面上的表单；例如，data={"example": "request"} 将作为 example=request 在请求正文中发送。另一方面，json 关键字将其参数编码为 JSON 值(并将 Content-Type header 设置为 application/json).