【python】requests模块初探（一）

一、写在前面

---

requests 是用python语言编写，基于 urllib，采用 apache2 licensed 开源协议的 http 库。它比 urllib 更加方便，可以节约我们大量的工作，完全满足 http 测试需求。requests 的哲学是以 pep 20 的习语为中心开发的，所以它比 urllib 更加 pythoner。

那么，requests都有哪些应用场景呢？

1.服务器编程基础；

2.爬虫利器；

3.自动化接口测试；

4.运维监控脚本

等等

本篇，我就记录一下requests最常用的两个请求方式和以及响应，其他内容后续更新

---

二、安装

安装很简单，只需要使用命令行安装即可：

pip install requests

三、请求

3.1 get请求

r = requests.get('https://api.github.com/events')

3.2 传递url参数的get请求

payload = {'key1': 'value1', 'key2': 'value2'}
r = requests.get("http://httpbin.org/get", params=payload)

3.3 请求cookies

url = 'http://httpbin.org/cookies'
cookies = dict(cookies_are='working')
r = requests.get(url, cookies=cookies)
#后面用到再详细分析

3.4 post请求

通常，想要发送一些编码为表单形式的数据——非常像一个 html 表单。要实现这个，只需简单地传递一个字典给 data 参数。你的数据字典在发出请求时会自动编码为表单形式：

payload = {'key1': 'value1', 'key2': 'value2'}
r = requests.post("http://httpbin.org/post", data=payload)

还可以为 data 参数传入一个元组列表。在表单中多个元素使用同一 key 的时候，这种方式尤其有效：

payload = (('key1', 'value1'), ('key1', 'value2'))
r = requests.post('http://httpbin.org/post', data=payload)

很多时候你想要发送的数据并非编码为表单形式的，例如你要传递一个 string 而不是一个 dict：

import json
url = 'https://api.github.com/some/endpoint'
payload = {'some': 'data'}
r = requests.post(url, data=json.dumps(payload))

或者是定义一个字符串的data

url = 'https://api.github.com/some/endpoint'
payload = '{"some": "data"}'
r = requests.post(url, data=payload)

此处除了可以自行对 dict 进行编码，你还可以使用 json 参数直接传递，然后它就会被自动编码

url = 'https://api.github.com/some/endpoint'
payload = {'some': 'data'}
r = requests.post(url, json=payload)

四、请求头

如果想为请求添加 http 头部，只要简单地传递一个 dict 给 headers 参数就可以了。

url = 'https://api.github.com/some/endpoint'
headers = {'user-agent': 'my-app/0.0.1'}
r = requests.get(url, headers=headers)

五、响应

前面的请求例子中，每个请求都会赋值给一个名为 r 的 response 对象，我们可以从这个对象中获取所有我们想要的信息

5.1获得请求url

payload = {'key1': 'value1', 'key2': ['value2', 'value3']}
r = requests.get('http://httpbin.org/get', params=payload)
print(r.url)
>>> http://httpbin.org/get?key1=value1&key2=value2&key2=value3

5.2获得响应内容

r = requests.get('https://api.github.com/events')
r.text #获得响应内容，类型为字符串
r.json() #如果 json 解码失败， r.json() 就会抛出一个异常
r.content #获得响应内容，类型为bytes-二进制响应内容
r.raw #原始响应内容，在罕见的情况下，你可能想获取来自服务器的原始套接字响应（后面会详细结合流数据来分析）

5.3响应状态码

r = requests.get('http://httpbin.org/get')
r.status_code

如果发送了一个错误请求(一个 4xx 客户端错误，或者 5xx 服务器错误响应)，我们可以通过 response.raise_for_status() 来抛出异常：

r = requests.get('http://httpbin.org/status/404')
r.status_code
>>> 404
r.raise_for_status()
>>>
traceback (most recent call last):
  file "requests/models.py", line 832, in raise_for_status
    raise http_error
requests.exceptions.httperror: 404 client error

5.4响应头

r.headers

5.5 response对象支持的所有方法

r.xxx #在ipython调试中，可以通过tab键来查看所有方法

该对象所有方法如下：

apparent_encoding
content
encoding
is_permanent_redirect
iter_lines
next
raw
status_code
close
cookies
headers
is_redirect
json
ok
reason
text
connection
elapsed
history
iter_content
links
raise_for_status
request
url

这里仅介绍了几个很常用的响应方法，后面遇到实际问题再展开讨论

六、超时

可以告诉 requests 在经过以 timeout 参数设定的秒数时间之后停止等待响应。基本上所有的生产代码都应该使用这一参数。如果不使用，你的程序可能会永远失去响应：

requests.get('http://github.com', timeout=0.001)

后记

以上的两种关于requests库请求方式及响应方法应该可以处理一些基本问题了，后面会继续探索requests库的其他功能。