Requests: 讓 HTTP 服務(wù)人類
雖然Python的標(biāo)準(zhǔn)庫中 urllib2 模塊已經(jīng)包含了平常我們使用的大多數(shù)功能,但是它的 API 使用起來讓人感覺不太好,而 Requests 自稱 “HTTP for Humans”,說明使用更簡潔方便。
Requests 唯一的一個(gè)非轉(zhuǎn)基因的 Python HTTP 庫,人類可以安全享用:)
Requests 繼承了urllib2的所有特性。Requests支持HTTP連接保持和連接池,支持使用cookie保持會(huì)話,支持文件上傳,支持自動(dòng)確定響應(yīng)內(nèi)容的編碼,支持國際化的 URL 和 POST 數(shù)據(jù)自動(dòng)編碼。
requests 的底層實(shí)現(xiàn)其實(shí)就是 urllib3
Requests的文檔非常完備,中文文檔也相當(dāng)不錯(cuò)。Requests能完全滿足當(dāng)前網(wǎng)絡(luò)的需求,支持Python 2.6—3.5,而且能在PyPy下完美運(yùn)行。
開源地址:https://github.com/kennethreitz/requests
中文文檔 API: http://docs.python-requests.org/zh_CN/latest/index.html
安裝方式
利用 pip 安裝 或者利用 easy_install 都可以完成安裝:
$ pip install requests
$ easy_install requests
基本GET請(qǐng)求(headers參數(shù) 和 parmas參數(shù))
1. 最基本的GET請(qǐng)求可以直接用get方法
response = requests.get("http://www.baidu.com/")
# 也可以這么寫
# response = requests.request("get", "http://www.baidu.com/")
2. 添加 headers 和 查詢參數(shù)
如果想添加 headers,可以傳入headers參數(shù)來增加請(qǐng)求頭中的headers信息。如果要將參數(shù)放在url中傳遞,可以利用 params 參數(shù)。
import requests
kw = {'wd':'長城'}
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"}
# params 接收一個(gè)字典或者字符串的查詢參數(shù),字典類型自動(dòng)轉(zhuǎn)換為url編碼,不需要urlencode()
response = requests.get("http://www.baidu.com/s?", params = kw, headers = headers)
# 查看響應(yīng)內(nèi)容,response.text 返回的是Unicode格式的數(shù)據(jù)
print response.text
# 查看響應(yīng)內(nèi)容,response.content返回的字節(jié)流數(shù)據(jù)
print respones.content
# 查看完整url地址
print response.url
# 查看響應(yīng)頭部字符編碼
print response.encoding
# 查看響應(yīng)碼
print response.status_code
運(yùn)行結(jié)果
......
......
'http://www.baidu.com/s?wd=%E9%95%BF%E5%9F%8E'
'utf-8'
200
- 使用response.text 時(shí),Requests 會(huì)基于 HTTP 響應(yīng)的文本編碼自動(dòng)解碼響應(yīng)內(nèi)容,大多數(shù) Unicode 字符集都能被無縫地解碼。
- 使用response.content 時(shí),返回的是服務(wù)器響應(yīng)數(shù)據(jù)的原始二進(jìn)制字節(jié)流,可以用來保存圖片等二進(jìn)制文件。
基本POST請(qǐng)求(data參數(shù))
1. 最基本的GET請(qǐng)求可以直接用post方法
response = requests.post("http://www.baidu.com/", data = data)
2. 傳入data數(shù)據(jù)
對(duì)于 POST 請(qǐng)求來說,我們一般需要為它增加一些參數(shù)。那么最基本的傳參方法可以利用 data 這個(gè)參數(shù)。
import requests
formdata = {
"type":"AUTO",
"i":"i love python",
"doctype":"json",
"xmlVersion":"1.8",
"keyfrom":"fanyi.web",
"ue":"UTF-8",
"action":"FY_BY_ENTER",
"typoResult":"true"
}
url = "http://fanyi.youdao.com/translate?smartresult=dict&smartresult=rule&smartresult=ugc&sessionFrom=null"
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"}
response = requests.post(url, data = formdata, headers = headers)
print response.text
# 如果是json文件可以直接顯示
print response.json()
運(yùn)行結(jié)果
{"type":"EN2ZH_CN","errorCode":0,"elapsedTime":2,"translateResult":[[{"src":"i love python","tgt":"我喜歡python"}]],"smartResult":{"type":1,"entries":["","肆文","高德納"]}}
{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參數(shù))
如果需要使用代理,你可以通過為任意請(qǐng)求方法提供 proxies 參數(shù)來配置單個(gè)請(qǐng)求:
import requests
# 根據(jù)協(xié)議類型,選擇不同的代理
proxies = {
"http": "http://12.34.56.79:9527",
"https": "http://12.34.56.79:9527",
}
response = requests.get("http://www.baidu.com", proxies = proxies)
print response.text
也可以通過本地環(huán)境變量 HTTP_PROXY 和 HTTPS_PROXY 來配置代理:
export HTTP_PROXY="http://12.34.56.79:9527"
export HTTPS_PROXY="https://12.34.56.79:9527"
私密代理驗(yàn)證(特定格式) 和 Web客戶端驗(yàn)證(auth 參數(shù))
urllib2 這里的做法比較復(fù)雜,requests只需要一步:
私密代理
import requests
# 如果代理需要使用HTTP Basic Auth,可以使用下面這種格式:
proxy = { "http": "mr_mao_hacker:sffqry9r@61.158.163.130:16816" }
response = requests.get("http://www.baidu.com", proxies = proxy)
print response.text
web客戶端驗(yàn)證
如果是Web客戶端驗(yàn)證,需要添加 auth = (賬戶名, 密碼)
import requests
auth=('test', '123456')
response = requests.get('http://192.168.199.107', auth = auth)
print response.text
urllib2 淚奔...
Cookies 和 Sission
Cookies
如果一個(gè)響應(yīng)中包含了cookie,那么我們可以利用 cookies參數(shù)拿到:
import requests
response = requests.get("http://www.baidu.com/")
# 7\. 返回CookieJar對(duì)象:
cookiejar = response.cookies
# 8\. 將CookieJar轉(zhuǎn)為字典:
cookiedict = requests.utils.dict_from_cookiejar(cookiejar)
print cookiejar
print cookiedict
運(yùn)行結(jié)果:
<RequestsCookieJar[<Cookie BDORZ=27315 for .baidu.com/>]>
{'BDORZ': '27315'}
Sission
在 requests 里,session對(duì)象是一個(gè)非常常用的對(duì)象,這個(gè)對(duì)象代表一次用戶會(huì)話:從客戶端瀏覽器連接服務(wù)器開始,到客戶端瀏覽器與服務(wù)器斷開。
會(huì)話能讓我們在跨請(qǐng)求時(shí)候保持某些參數(shù),比如在同一個(gè) Session 實(shí)例發(fā)出的所有請(qǐng)求之間保持 cookie 。
實(shí)現(xiàn)人人網(wǎng)登錄
import requests
# 1\. 創(chuàng)建session對(duì)象,可以保存Cookie值
ssion = requests.session()
# 2\. 處理 headers
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"}
# 3\. 需要登錄的用戶名和密碼
data = {"email":"mr_mao_hacker@163.com", "password":"alarmchime"}
# 4\. 發(fā)送附帶用戶名和密碼的請(qǐng)求,并獲取登錄后的Cookie值,保存在ssion里
ssion.post("http://www.renren.com/PLogin.do", data = data)
# 5\. ssion包含用戶登錄后的Cookie值,可以直接訪問那些登錄后才可以訪問的頁面
response = ssion.get("http://www.renren.com/410043129/profile")
# 6\. 打印響應(yīng)內(nèi)容
print response.text

處理HTTPS請(qǐng)求 SSL證書驗(yàn)證
Requests也可以為HTTPS請(qǐng)求驗(yàn)證SSL證書:
- 要想檢查某個(gè)主機(jī)的SSL證書,你可以使用 verify 參數(shù)(也可以不寫)
import requests
response = requests.get("https://www.baidu.com/", verify=True)
# 也可以省略不寫
# response = requests.get("https://www.baidu.com/")
print r.text
運(yùn)行結(jié)果:
<!DOCTYPE html>
<!--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證書驗(yàn)證不通過,或者不信任服務(wù)器的安全證書,則會(huì)報(bào)出SSLError,據(jù)說 12306 證書是自己做的:

來測試一下:
import requests
response = requests.get("https://www.12306.cn/mormhweb/")
print response.text
果然:
SSLError: ("bad handshake: Error([('SSL routines', 'ssl3_get_server_certificate', 'certificate verify failed')],)",)
如果我們想跳過 12306 的證書驗(yàn)證,把 verify 設(shè)置為 False 就可以正常請(qǐng)求了。
r = requests.get("https://www.12306.cn/mormhweb/", verify = False)