在 Python 中使用请求发出 HTTP POST 请求

Question

我正在尝试使用 POST 方法向 API 发出 HTTP 请求。我使用的 API 旨在接收三个参数（key1、key2、key3）并返回一个 json 文件。不幸的是，当我使用 data 方法将字典传递给 API 时，我的 POST 请求似乎没有返回任何内容。这似乎很奇怪，因为当我使用 params 方法时它似乎工作。我无法理解这一点，因为这个过程似乎非常不透明（例如，我无法通过 URL 查看有效负载是如何传递到 API 的）。

我的问题：我在这里做错了什么？

使用 data 方法将参数发送到 API 的 POST 请求：

import requests

url = 'http://example.com/API.php'
payload =  {
            'key1': '<<Contains very long json string>>', 
            'key2': 5, 
            'key3': 0
           }

print len(str(payload)) # Prints 6717
r = requests.post(url, data=payload) << Note data is used here
print r.status_code # Prints 200
print r.text # Prints empty string

使用 params 方法将参数发送到 API 的 POST 请求代码：

import requests

url = 'http://example.com/API.php'
payload =  {
            'key1': '<<Contains very long json string>>', 
            'key2': 5, 
            'key3': 0
           }

print len(str(payload)) # Prints 6717
r = requests.post(url, params=payload) << Note here params is used here
print r.status_code # Prints 200
print r.text # Prints expected JSON results

如果您想知道为什么我想使用 data 方法而不是 params... 我正在尝试传递包含更长字符串的其他字典和 params 方法似乎没有这样做，因为我收到 ERROR 414。我希望可以通过使用 data 解决该错误。

我使用的 API 是用 PHP 编写的。

Answer 1

简答
这是因为 params 将参数作为 http POST 请求的一部分发送，而 data 将它们作为请求正文的一部分发送。在您的情况下：只需使用参数调用 api 就可以了。这是绝对正常（和预期）的行为。

演示
只需启动两个命令行。首先，运行 netcat：nc -l 8888。在另一个命令行上，运行 python：

>>> import requests
>>> requests.post('http://localhost:8888',data={'a':1,'b':'2'})

在netcat端，我们看到如下请求：

POST / HTTP/1.1
Host: localhost:8888
Connection: keep-alive
Accept-Encoding: gzip, deflate
Accept: */*
User-Agent: python-requests/2.18.1
Content-Length: 7
Content-Type: application/x-www-form-urlencoded

a=1&b=2

接下来，试试params方式：

>>> requests.post('http://localhost:8888',params={'a':1,'b':'2'})

Netcat 报告：

POST /?a=1&b=2 HTTP/1.1
Host: localhost:8888
Connection: keep-alive
Accept-Encoding: gzip, deflate
Accept: */*
User-Agent: python-requests/2.18.1
Content-Length: 0

注意第一行和最后一行的区别。

正如您从documentation 中看到的那样（斜体强调是我的）：

params -- （可选）在查询字符串中为请求发送的字典或字节。
data -- （可选）字典或元​​组列表 [(key, value)]（将被形式编码）、字节或类似文件的对象发送在请求的正文中。