Python-第三方模塊requests快速入手


首先確認一下 

  • Requests 已經安裝
  • Requests 是最新的版本

如果沒有安裝requests,請按照下面的方式安裝

安裝requests

window和Linux環境下都可以輸入

$ pip install requests

發送請求

使用requests可以發送get、post、put、delete、head以及options等類型的Http請求

使用Requests發送網絡請求非常簡單,首先要導入Requests模塊:

>>> import requests

然后,嘗試獲取某個網頁

>>> r = requests.get('https://dc.kellyx.com:9635/match/games?pageNum=1&matchId=&countryId=')

>>> print(r.text)

傳遞URL參數

你也許經常想為 URL 的查詢字符串(query string)傳遞某種數據。如果你是手工構建 URL,那么數據會以鍵/值對的形式置於 URL 中,跟在一個問號的后面。例如, httpbin.org/get?key=val。 Requests 允許你使用 params 關鍵字參數,以一個字符串字典來提供這些參數。舉例來說,如果你想傳遞 key1=value1 和 key2=value2 到 httpbin.org/get ,那么你可以使用如下代碼:

 

>>> payload = {"pageNum":1,"matchId":"","countryId":""} 
>>> url =
"https://dc.kellyx.com:9635/match/games"
>>>h = {

"Accept": "application/json,text/plain,*/*",
"User-Agent": "Mozilla/5.0(Linux;Android6.0;Nexus  5Build/MRA58N) AppleWebKit/537.36(KHTML,likeGecko) Chrome/68.0.3440.106 Mobile Safari/537.36"
}
>>> r = requests.get(url,params =payload,header=h)

通過打印輸出該 URL,你能看到 URL 已被正確編碼:

>>> print(r.url)

注意字典里值為 None 的鍵都不會被添加到 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

響應內容

我們能讀取服務器響應的內容,

Requests 會自動解碼來自服務器的內容。大多數 unicode 字符集都能被無縫地解碼。

請求發出后,Requests 會基於 HTTP 頭部對響應的編碼作出有根據的推測。當你訪問 r.text 之時,Requests 會使用其推測的文本編碼。你可以找出 Requests 使用了什么編碼,並且能夠使用r.encoding 屬性來改變它:

>>> r.encoding 'utf-8' >>> r.encoding = 'ISO-8859-1'

其他操作

response的返回內容還有其它更多信息
>>> r.status_code          #響應狀態碼
>>> r.content              #字節方式的響應體,會自動為你解碼 gzip 和 deflate 壓縮
>>> r.headers              #以字典對象存儲服務器響應頭,但是這個字典比較特殊,字典鍵不區分大小寫,若鍵不存在則返回None
>>> r.url                   # 獲取url
>>> r.encoding              # 編碼格式
>>> r.cookies               # 獲取返回的cookie
>>> r.text                  #字符串方式的響應體,會自動根據響應頭部的字符編碼進行解碼
>>> r.raise_for_status()  #失敗請求(非200響應)拋出異常

>>> r.json()                #Requests中內置的JSON解碼器 ,json轉成python的字典了

如果 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 頭部,只要簡單地傳遞一個 dict 給 headers 參數就可以了。

例如,在前一個示例中我們沒有指定 content-type:

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

注意: 定制 header 的優先級低於某些特定的信息源,例如:

  • 如果在 .netrc 中設置了用戶認證信息,使用 headers= 設置的授權就不會生效。而如果設置了 auth= 參數,``.netrc`` 的設置就無效了。
  • 如果被重定向到別的主機,授權 header 就會被刪除。
  • 代理授權 header 會被 URL 中提供的代理身份覆蓋掉。
  • 在我們能判斷內容長度的情況下,header 的 Content-Length 會被改寫。

更進一步講,Requests 不會基於定制 header 的具體情況改變自己的行為。只不過在最后的請求中,所有的 header 信息都會被傳遞進去。

注意: 所有的 header 值必須是 string、bytestring 或者 unicode。盡管傳遞 unicode header 也是允許的,但不建議這樣做。

更加復雜的 POST 請求

帶有參數的Post請求的樣式主要有兩個類型,一類是參數在URL中,一類是在body中。

常見的四類形式:

  • application/json: {“key1“:”value1”,“keyt2":“value2"}
  • application/x-www-form-urlencoded:name1= value1&name2=value2
  • multipart/form-data:這一種是表單格式的(文件上傳,圖片上傳等混合式)
  • Content-Type:octets/stream(文件下載)

通常,你想要發送一些編碼為表單形式的數據——非常像一個 HTML 表單。要實現這個,只需簡單地傳遞一個字典給 data 參數。你的數據字典在發出請求時會自動編碼為表單形式:

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

你還可以為 data 參數傳入一個元組列表。在表單中多個元素使用同一 key 的時候,這種方式尤其有效:

>>> payload = (('key1', 'value1'), ('key1', 'value2')) >>> r = requests.post('http://httpbin.org/post', data=payload) >>> print(r.text) {  ...  "form": {  "key1": [  "value1",  "value2"  ]  },  ... } 

很多時候你想要發送的數據並非編碼為表單形式的。如果你傳遞一個 string 而不是一個 dict,那么數據會被直接發布出去。

例如,Github API v3 接受編碼為 JSON 的 POST/PATCH 數據:

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

此處除了可以自行對 dict 進行編碼,你還可以使用 json 參數直接傳遞,然后它就會被自動編碼。這是 2.4.2 版的新加功能:

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

POST一個多部分編碼(Multipart-Encoded)的文件

Requests 使得上傳多部分編碼文件變得很簡單:

>>> url = 'http://httpbin.org/post' >>> files = {'file': open('report.xls', 'rb')} >>> r = requests.post(url, files=files) >>> r.text {  ...  "files": {  "file": "<censored...binary...data>"  },  ... } 

你可以顯式地設置文件名,文件類型和請求頭:

>>> url = 'http://httpbin.org/post' >>> files = {'file': ('report.xls', open('report.xls', 'rb'), 'application/vnd.ms-excel', {'Expires': '0'})} >>> r = requests.post(url, files=files) >>> r.text {  ...  "files": {  "file": "<censored...binary...data>"  },  ... } 

如果你想,你也可以發送作為文件來接收的字符串:

>>> url = 'http://httpbin.org/post' >>> files = {'file': ('report.csv', 'some,data,to,send\nanother,row,to,send\n')} >>> r = requests.post(url, files=files) >>> r.text {  ...  "files": {  "file": "some,data,to,send\\nanother,row,to,send\\n"  },  ... } 

如果你發送一個非常大的文件作為 multipart/form-data 請求,你可能希望將請求做成數據流。默認下 requests 不支持, 但有個第三方包 requests-toolbelt 是支持的。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM