在命令行输入 pip install requests 即可安装模块成功。
发送请求
导入模块,然后尝试获取某个网页:
import requests
r = requests.get(‘https://api.github.com/events’)
现在,我们有一个名为 r 的 Response 对象。我们可以从这个对象中获取所有我们想要的信息。
传递URL参数
Requests 允许使用 params 关键字参数,以一个字符串字典来提供这些参数。
>>> payload = {
'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get("http://httpbin.org/get", params=payload)
>>> print(r.url)
http://httpbin.org/get?key1=value1&key2=value2
响应内容
读取响应内容。
Requests 会自动解码来自服务器的内容。大多数 unicode 字符集都能被无缝地解码。
Requests 中也有一个内置的 JSON 解码器,助你处理 JSON 数据:
r = requests.get(‘https://api.github.com/events’)
r.json()
如果 JSON 解码失败, r.json() 就会抛出一个异常。例如,响应内容是 401 (Unauthorized),尝试访问 r.json() 将会抛出 ValueError: No JSON object could be decoded 异常。
需要注意的是,成功调用 r.json() 并不意味着响应的成功。有的服务器会在失败的响应中包含一个 JSON 对象(比如 HTTP 500 的错误细节)。这种 JSON 会被解码返回。要检查请求是否成功,请使用 r.raise_for_status() 或者检查 r.status_code 是否和你的期望相同。
定制请求头
如果你想为请求添加 HTTP 头部,只要简单地传递一个字典 给 headers 参数就可以了。
>>> url = 'https://api.github.com/some/endpoint'
>>> headers = {
'user-agent': 'my-app/0.0.1'}
>>> r = requests.get(url, headers=headers)
更加复杂的POST请求
通常,你想要发送一些编码为表单形式的数据——非常像一个 HTML 表单。要实现这个,只需简单地传递一个字典给 data 参数。你的数据字典在发出请求时会自动编码为表单形式:
>>> payload = {
'key1': 'value1', 'key2': 'value2'}
>>> r = requests.post("http://httpbin.org/post", data=payload