python——Request模块

Requests: 让 HTTP 服务人类

虽然Python的标准库中 urllib2 模块已经包含了平常我们使用的大多数功能，但是它的 API 使用起来让人感觉不太好，而 Requests 自称 “HTTP for Humans”，说明使用更简洁方便。

Requests 唯一的一个非转基因的 Python HTTP 库，人类可以安全享用：）

Requests 继承了urllib2的所有特性。Requests支持HTTP连接保持和连接池，支持使用cookie保持会话，支持文件上传，支持自动确定响应内容的编码，支持国际化的 URL 和 POST 数据自动编码。

requests 的底层实现其实就是 urllib3

Requests的文档非常完备，中文文档也相当不错。Requests能完全满足当前网络的需求，支持Python 2.6—3.5，而且能在PyPy下完美运行。

开源地址：https://github.com/kennethreitz/requests

中文文档 API： http://docs.python-requests.org/zh_CN/latest/index.html

安装方式

利用 pip 安装 或者利用 easy_install 都可以完成安装：

1. $ pip install requests
2. $ easy_install requests

基本GET请求（headers参数 和 parmas参数）

1. 最基本的GET请求可以直接用get方法

1. response = requests.get('http://www.baidu.com/')
2. # 也可以这么写
3. # response = requests.request('get', 'http://www.baidu.com/')

2. 添加 headers 和 查询参数

如果想添加 headers，可以传入headers参数来增加请求头中的headers信息。如果要将参数放在url中传递，可以利用 params 参数。

1. import requests
2. kw = {'wd':'长城'}
3. headers = {'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.99 Safari/537.36'}
4. # params 接收一个字典或者字符串的查询参数，字典类型自动转换为url编码，不需要urlencode()
5. response = requests.get('http://www.baidu.com/s?', params = kw, headers = headers)
6. # 查看响应内容，response.text 返回的是Unicode格式的数据
7. print response.text
8. # 查看响应内容，response.content返回的字节流数据
9. print respones.content
10. # 查看完整url地址
11. print response.url
12. # 查看响应头部字符编码
13. print response.encoding
14. # 查看响应码
15. print response.status_code

运行结果

1. ......
2. ......
3. 'http://www.baidu.com/s?wd=%E9%95%BF%E5%9F%8E'
4. 'utf-8'
5. 200

• 使用response.text 时，Requests 会基于 HTTP 响应的文本编码自动解码响应内容，大多数 Unicode 字符集都能被无缝地解码。

• 使用response.content 时，返回的是服务器响应数据的原始二进制字节流，可以用来保存图片等二进制文件。

基本POST请求（data参数）

1. 最基本的GET请求可以直接用post方法

response = requests.post('http://www.baidu.com/', data = data)

2. 传入data数据

对于 POST 请求来说，我们一般需要为它增加一些参数。那么最基本的传参方法可以利用 data 这个参数。

1. import requests
2. formdata = {
3. 'type':'AUTO',
4. 'i':'i love python',
5. 'doctype':'json',
6. 'xmlVersion':'1.8',
7. 'keyfrom':'fanyi.web',
8. 'ue':'UTF-8',
9. 'action':'FY_BY_ENTER',
10. 'typoResult':'true'
11. }
12. url = 'http://fanyi.youdao.com/translate?smartresult=dict&smartresult=rule&smartresult=ugc&sessionFrom=null'
13. headers={ 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36'}
14. response = requests.post(url, data = formdata, headers = headers)
15. print response.text
16. # 如果是json文件可以直接显示
17. print response.json()

运行结果

1. {'type':'EN2ZH_CN','errorCode':0,'elapsedTime':2,'translateResult':[[{'src':'i love python','tgt':'我喜欢python'}]],'smartResult':{'type':1,'entries':['','肆文','高德纳']}}
2. {u'errorCode': 0, u'elapsedTime': 0, u'translateResult': [[{u'src': u'i love python', u'tgt': u'\u6211\u559c\u6b22python'}]], u'smartResult': {u'type': 1, u'entries': [u'', u'\u8086\u6587', u'\u9ad8\u5fb7\u7eb3']}, u'type': u'EN2ZH_CN'}

代理（proxies参数）

如果需要使用代理，你可以通过为任意请求方法提供 proxies 参数来配置单个请求：

1. import requests
2. # 根据协议类型，选择不同的代理
3. proxies = {
4. 'http': 'http://12.34.56.79:9527',
5. 'https': 'http://12.34.56.79:9527',
6. }
7. response = requests.get('http://www.baidu.com', proxies = proxies)
8. print response.text

也可以通过本地环境变量 HTTP_PROXY 和 HTTPS_PROXY 来配置代理：

1. export HTTP_PROXY='http://12.34.56.79:9527'
2. export HTTPS_PROXY='https://12.34.56.79:9527'

私密代理验证（特定格式） 和 Web客户端验证（auth 参数）

urllib2 这里的做法比较复杂，requests只需要一步：

私密代理

1. import requests
2. # 如果代理需要使用HTTP Basic Auth，可以使用下面这种格式：
3. proxy = { 'http': 'mr_mao_hacker:sffqry9r@61.158.163.130:16816' }
4. response = requests.get('http://www.baidu.com', proxies = proxy)
5. print response.text

web客户端验证

如果是Web客户端验证，需要添加 auth = (账户名, 密码)

1. import requests
2. auth=('test', '123456')
3. response = requests.get('http://192.168.199.107', auth = auth)
4. print response.text

urllib2 泪奔...

Cookies 和 Sission

Cookies

如果一个响应中包含了cookie，那么我们可以利用 cookies参数拿到：

1. import requests
2. response = requests.get('http://www.baidu.com/')
3. # 7. 返回CookieJar对象:
4. cookiejar = response.cookies
5. # 8. 将CookieJar转为字典：
6. cookiedict = requests.utils.dict_from_cookiejar(cookiejar)
7. print cookiejar
8. print cookiedict

运行结果：

1. <RequestsCookieJar[<Cookie BDORZ=27315 for .baidu.com/>]>
2. {'BDORZ': '27315'}

Sission

在 requests 里，session对象是一个非常常用的对象，这个对象代表一次用户会话：从客户端浏览器连接服务器开始，到客户端浏览器与服务器断开。

会话能让我们在跨请求时候保持某些参数，比如在同一个 Session 实例发出的所有请求之间保持 cookie 。

实现人人网登录

1. import requests
2. # 1. 创建session对象，可以保存Cookie值
3. ssion = requests.session()
4. # 2. 处理 headers
5. headers = {'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.99 Safari/537.36'}
6. # 3. 需要登录的用户名和密码
7. data = {'email':'[e-mail]', 'password':'alarmchime'}
8. # 4. 发送附带用户名和密码的请求，并获取登录后的Cookie值，保存在ssion里
9. ssion.post('http://www.renren.com/PLogin.do', data = data)
10. # 5. ssion包含用户登录后的Cookie值，可以直接访问那些登录后才可以访问的页面
11. response = ssion.get('http://www.renren.com/410043129/profile')
12. # 6. 打印响应内容
13. print response.text

处理HTTPS请求 SSL证书验证

Requests也可以为HTTPS请求验证SSL证书：

• 要想检查某个主机的SSL证书，你可以使用 verify 参数（也可以不写）

1. import requests
2. response = requests.get('https://www.baidu.com/', verify=True)
3. # 也可以省略不写
4. # response = requests.get('https://www.baidu.com/')
5. print r.text

运行结果：

1. <!DOCTYPE html>
2. <!--STATUS OK--><html> <head><meta http-equiv=content-type content=text/html;charset=utf-8><meta http-equiv=X-UA-Compatible content=IE=Edge>百度一下，你就知道 ....

• 如果SSL证书验证不通过，或者不信任服务器的安全证书，则会报出SSLError，据说 12306 证书是自己做的：

来测试一下：

1. import requests
2. response = requests.get('https://www.12306.cn/mormhweb/')
3. print response.text

果然：

SSLError: ('bad handshake: Error([('SSL routines', 'ssl3_get_server_certificate', 'certificate verify failed')],)',)

如果我们想跳过 12306 的证书验证，把 verify 设置为 False 就可以正常请求了。

r = requests.get('https://www.12306.cn/mormhweb/', verify = False)