安裝
pip install requests
Response對象
Response對象包含服務(wù)器返回的所有信息错忱，也包含請求的Request信息
Requests庫的2個(gè)重要對象@2x.png
Response 對象的屬性
| 屬性 | 說明 |
|---|---|
| r.status_code | HTTP請求的返回狀態(tài)浪慌，200表示連接成功遂唧，404表示失敗 |
| r.text | HTTP響應(yīng)內(nèi)容的字符串形式抡句，即愈涩，url對應(yīng)的頁面內(nèi)容 |
| r.encoding | 從HTTP header中猜測的響應(yīng)內(nèi)容編碼方式 |
| r.apparent_encoding | 從內(nèi)容中分析出的響應(yīng)內(nèi)容編碼方式(備選編碼方式) |
| r.content | HTTP響應(yīng)內(nèi)容的二進(jìn)制形式 |
Response 對象的屬性@2x.png
Response 對象的編碼
- r.encoding:如果header中不存在charset笔刹，則認(rèn)為編碼為ISO‐8859‐1 r.text根據(jù)r.encoding顯示網(wǎng)頁內(nèi)容
- r.apparent_encoding:根據(jù)網(wǎng)頁內(nèi)容分析出的編碼方式 可以看作是r.encoding的備選
Requests 庫的異常
| 異常 | 說明 |
|---|---|
| requests.ConnectionError | 網(wǎng)絡(luò)連接錯(cuò)誤異常尖坤，如DNS查詢失敗囱持、拒絕連接等 |
| requests.HTTPError | HTTP錯(cuò)誤異常 |
| requests.URLRequired | URL缺失異常 |
| requests.TooManyRedirects | 超過最大重定向次數(shù)夯接，產(chǎn)生重定向異常 |
| requests.ConnectTimeout | 連接遠(yuǎn)程服務(wù)器超時(shí)異常 |
| requests.Timeout | 請求URL超時(shí)，產(chǎn)生超時(shí)異常 |
| r.raise_for_status() | 如果不是200纷妆，產(chǎn)生異常 requests.HTTPError |
- r.raise_for_status()在方法內(nèi)部判斷r.status_code是否等于200盔几，不需要 增加額外的if語句，該語句便于利用try‐except進(jìn)行異常處理
try:
r = requests.get("http://www.baidu.com/")
r.raise_for_status()
r.encoding = r.apparent_encoding
print(r.text)
except:
print("產(chǎn)生異常")
HTTP協(xié)議 與 Requests庫
| HTTP協(xié)議方法 | Requests庫方法 | 功能一致性 |
|---|---|---|
| GET | requests.get() | 一致 |
| HEAD | requests.head() | 一致 |
| POST | requests.post() | 一致 |
| PUT | requests.put() | 一致 |
| PATCH | requests.patch() | 一致 |
| DELETE | requests.delete() | 一致 |
- GET 請求獲取URL位置的資源
- HEAD 請求獲取URL位置資源的響應(yīng)消息報(bào)告掩幢，即獲得該資源的頭部信息
- POST 請求向URL位置的資源后附加新的數(shù)據(jù)
- PUT 請求向URL位置存儲(chǔ)一個(gè)資源逊拍，覆蓋原URL位置的資源
- PATCH 請求局部更新URL位置的資源，即改變該處資源的部分內(nèi)容
- DELETE 請求刪除URL位置存儲(chǔ)的資源
PATCH 和 PUT 的區(qū)別
假設(shè)URL位置有一組數(shù)據(jù)UserInfo际邻，包括UserID芯丧、UserName等20個(gè)字段
需求:用戶修改了UserName，其他不變
- 采用PATCH世曾，僅向URL提交UserName的局部更新請求
- 采用PUT缨恒，必須將所有20個(gè)字段一并提交到URL，未提交字段被刪除 PATCH的最主要好處:節(jié)省網(wǎng)絡(luò)帶寬
Requests 庫的7個(gè)主要方法
| 方法 | 說明 |
|---|---|
| requests.request() | 構(gòu)造一個(gè)請求轮听，支撐以下各方法的基礎(chǔ)方法 |
| requests.get() | 獲取HTML網(wǎng)頁的主要方法肿轨，對應(yīng)于HTTP的GET |
| requests.head() | 獲取HTML網(wǎng)頁頭信息的方法，對應(yīng)于HTTP的HEAD |
| requests.post() | 向HTML網(wǎng)頁提交POST請求的方法蕊程，對應(yīng)于HTTP的POST |
| requests.put() | 向HTML網(wǎng)頁提交PUT請求的方法椒袍，對應(yīng)于HTTP的PUT |
| requests.patch() | 向HTML網(wǎng)頁提交局部修改請求，對應(yīng)于HTTP的PATCH |
| requests.delete() | 向HTML頁面提交刪除請求藻茂，對應(yīng)于HTTP的DELETE |
requests.request()
requests.request(method, url, **kwargs)
- method : 請求方式驹暑，對應(yīng)get/put/post等7種
- r = requests.request('GET', url, **kwargs)
- r = requests.request('HEAD', url, **kwargs)
- r = requests.request('POST', url, **kwargs)
- r = requests.request('PUT', url, **kwargs)
- r = requests.request('PATCH', url, **kwargs)
- r = requests.request('delete', url, **kwargs) r = requests.request('OPTIONS', url, **kwargs)
- url : 擬獲取頁面的url鏈接
- **kwargs :控制訪問的參數(shù)，共13個(gè)辨赐，均為可選項(xiàng)
- params : 字典或字節(jié)序列优俘，作為參數(shù)增加到url中
- data : 字典、字節(jié)序列或文件對象掀序，作為Request的內(nèi)容
- json : JSON格式的數(shù)據(jù)帆焕，作為Request的內(nèi)容
- headers : 字典，HTTP定制頭
- cookies : 字典或CookieJar不恭，Request中的cookie
- auth : 元組叶雹，支持HTTP認(rèn)證功能
- files : 字典類型财饥，傳輸文件
- timeout : 設(shè)定超時(shí)時(shí)間，秒為單位
- proxies : 字典類型折晦，設(shè)定訪問代理服務(wù)器钥星，可以增加登錄認(rèn)證
- allow_redirects : True/False，默認(rèn)為True满着，重定向開關(guān)
- stream : True/False谦炒，默認(rèn)為True，獲取內(nèi)容立即下載開關(guān)
- verify : True/False风喇，默認(rèn)為True宁改，認(rèn)證SSL證書開關(guān)
- cert : 本地SSL證書路徑
requests.get()
requests.get(url, params=None, **kwargs)
- url : 擬獲取頁面的url鏈接
- params : url中的額外參數(shù)，字典或字節(jié)流格式魂莫，可選
- **kwargs: 12個(gè)控制訪問的參數(shù)
requests.head()
requests.head(url, **kwargs)
- url : 擬獲取頁面的url鏈接
- **kwargs: 12個(gè)控制訪問的參數(shù)
requests.post()
requests.post(url, data=None, json=None, **kwargs)
- url : 擬更新頁面的url鏈接
- data : 字典透且、字節(jié)序列或文件，Request的內(nèi)容
- json : JSON格式的數(shù)據(jù)豁鲤，Request的內(nèi)容
- **kwargs: 12個(gè)控制訪問的參數(shù)
requests.put()
requests.put(url, data=None, **kwargs)
- url : 擬更新頁面的url鏈接
- data : 字典、字節(jié)序列或文件鲸沮，Request的內(nèi)容
- **kwargs: 12個(gè)控制訪問的參數(shù)
requests.patch()
requests.patch(url, data=None, **kwargs)
- url : 擬更新頁面的url鏈接
- data : 字典琳骡、字節(jié)序列或文件，Request的內(nèi)容
- **kwargs: 12個(gè)控制訪問的參數(shù)
requests.delete()
requests.delete(url, **kwargs)
- url : 擬刪除頁面的url鏈接
- **kwargs: 12個(gè)控制訪問的參數(shù)
