Python中Requests庫的用法

Requests庫的安裝python

利用 pip 安裝，若是你安裝了pip包（一款Python包管理工具，不知道能夠百度喲），或者集成環境，好比Python（x,y）或者anaconda的話，就能夠直接使用pip安裝Python的庫。git

$ pip install requestsgithub

安裝完成以後，下面來看一下基本的方法：web

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

#get請求方法
>>> r = requests. get ( 'https://api.github.com/user' , auth = ( 'user' , 'pass' ) )
#打印get請求的狀態碼
>>> r. status_code
200
#查看請求的數據類型，能夠看到是json格式，utf-8編碼
>>> r. headers [ 'content-type' ]
'application/json; charset=utf8'
>>> r. encoding
'utf-8'
#打印請求到的內容
>>> r. text
u '{"type":"User"...'
#輸出json格式數據
>>> r. json ( )
{u 'private_gists': 419 , u 'total_private_repos': 77 , ... }

下面看一個小栗子：json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

#小例子
import requests

r = requests. get ( 'http://www.baidu.com' )
print type (r )
print r. status_code
print r. encoding
print r. text
print r. cookies

'''請求了百度的網址，而後打印出了返回結果的類型，狀態碼，編碼方式，Cookies等內容
輸出：'''
< class 'requests.models.Response' >
200
UTF- 8
<RequestsCookieJar [ ] >

http基本請求

requests庫提供了http全部的基本請求方式。例如：api

1
2
3
4
5

r = requests. post ( "http://httpbin.org/post" )
r = requests. put ( "http://httpbin.org/put" )
r = requests. delete ( "http://httpbin.org/delete" )
r = requests. head ( "http://httpbin.org/get" )
r = requests. options ( "http://httpbin.org/get" )

基本GET請求

1
2
3
4
5
6
7
8

r = requests. get ( "http://httpbin.org/get" )
#若是想要加參數，能夠利用 params 參數：
import requests
payload = { 'key1': 'value1' , 'key2': 'value2' }
r = requests. get ( "http://httpbin.org/get" , params =payload )
print r. url

#輸出：http://httpbin.org/get?key2=value2&key1=value1

若是想請求JSON文件，能夠利用 json() 方法解析，例如本身寫一個JSON文件命名爲a.json，內容以下：瀏覽器

1
2
3
4
5
6
7
8
9
10
11
12
13
14

[ "foo" , "bar" , {
"foo": "bar"
} ]
#利用以下程序請求並解析：
import requests
r = requests. get ( "a.json" )
print r. text
print r. json ( )
'''運行結果以下，其中一個是直接輸出內容，另一個方法是利用 json() 方法
解析，感覺下它們的不一樣:'''
[ "foo" , "bar" , {
"foo": "bar"
} ]
[u 'foo' , u 'bar' , {u 'foo': u 'bar' } ]

若是想獲取來自服務器的原始套接字響應，能夠取得 r.raw 。不過須要在初始請求中設置 stream=True 。服務器

1
2
3
4
5
6

r = requests. get ( 'https://github.com/timeline.json' , stream = True )
r. raw
#輸出
<requests. packages. urllib3. response. HTTPResponse object at 0x101194810 >
r. raw. read ( 10 )
'\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\x03'

這樣就獲取了網頁原始套接字內容。cookie

若是想添加 headers，能夠傳 headers 參數：session

1
2
3
4
5
6
7

import requests

payload = { 'key1': 'value1' , 'key2': 'value2' }
headers = { 'content-type': 'application/json' }
r = requests. get ( "http://httpbin.org/get" , params =payload , headers =headers )
print r. url
#經過headers參數能夠增長請求頭中的headers信息

基本POST請求

對於 POST 請求來講，咱們通常須要爲它增長一些參數。那麼最基本的傳參方法能夠利用 data 這個參數。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

import requests

payload = { 'key1': 'value1' , 'key2': 'value2' }
r = requests. post ( "http://httpbin.org/post" , data =payload )
print r. text
#運行結果以下：
{
"args": { } ,
"data": "" ,
"files": { } ,
"form": {
"key1": "value1" ,
"key2": "value2"
} ,
"headers": {
"Accept": "*/*" ,
"Accept-Encoding": "gzip, deflate" ,
"Content-Length": "23" ,
"Content-Type": "application/x-www-form-urlencoded" ,
"Host": "httpbin.org" ,
"User-Agent": "python-requests/2.9.1"
} ,
"json": null ,
"url": "http://httpbin.org/post"
}

能夠看到參數傳成功了，而後服務器返回了咱們傳的數據。

有時候咱們須要傳送的信息不是表單形式的，須要咱們傳JSON格式的數據過去，因此咱們能夠用 json.dumps() 方法把表單數據序列化。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

import json
import requests

url = 'http://httpbin.org/post'
payload = { 'some': 'data' }
r = requests. post (url , data =json. dumps (payload ) )
print r. text

#運行結果：
{
"args": { } ,
"data": "{\"some\": \"data\"}" ,
"files": { } ,
"form": { } ,
"headers": {
"Accept": "*/*" ,
"Accept-Encoding": "gzip, deflate" ,
"Content-Length": "16" ,
"Host": "httpbin.org" ,
"User-Agent": "python-requests/2.9.1"
} ,
"json": {
"some": "data"
} ,
"url": "http://httpbin.org/post"
}

經過上述方法，咱們能夠POST JSON格式的數據

若是想要上傳文件，那麼直接用 file 參數便可：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

#新建一個 test.txt 的文件，內容寫上 Hello World!
import requests

url = 'http://httpbin.org/post'
files = { 'file': open ( 'test.txt' , 'rb' ) }
r = requests. post (url , files =files )
print r. text

{
"args": { } ,
"data": "" ,
"files": {
"file": "Hello World!"
} ,
"form": { } ,
"headers": {
"Accept": "*/*" ,
"Accept-Encoding": "gzip, deflate" ,
"Content-Length": "156" ,
"Content-Type": "multipart/form-data; boundary=7d8eb5ff99a04c11bb3e862ce78d7000" ,
"Host": "httpbin.org" ,
"User-Agent": "python-requests/2.9.1"
} ,
"json": null ,
"url": "http://httpbin.org/post"
}

這樣咱們便成功完成了一個文件的上傳。

requests 是支持流式上傳的，這容許你發送大的數據流或文件而無需先把它們讀入內存。要使用流式上傳，僅需爲你的請求體提供一個類文件對象便可，很是方便：

1 2	with open ( 'massive-body' ) as f: requests. post ( 'http://some.url/streamed' , data =f )

Cookies

若是一個響應中包含了cookie，那麼咱們能夠利用 cookies 變量來拿到：

1
2
3
4
5
6

import requests

url = 'http://example.com'
r = requests. get (url )
print r. cookies
print r. cookies [ 'example_cookie_name' ]

以上程序僅是樣例，能夠用 cookies 變量來獲得站點的 cookies

另外能夠利用 cookies 變量來向服務器發送 cookies 信息:

1
2
3
4
5
6
7
8

import requests

url = 'http://httpbin.org/cookies'
cookies = dict (cookies_are = 'working' )
r = requests. get (url , cookies =cookies )
print r. text
#輸出：
'{"cookies": {"cookies_are": "working"}}'

超時配置

能夠利用 timeout 變量來配置最大請求時間
requests.get(‘http://github.com’, timeout=0.001)
注：timeout 僅對鏈接過程有效，與響應體的下載無關。

也就是說，這個時間只限制請求的時間。即便返回的 response 包含很大內容，下載須要必定時間。

會話對象

在以上的請求中，每次請求其實都至關於發起了一個新的請求。也就是至關於咱們每一個請求都用了不一樣的瀏覽器單獨打開的效果。也就是它並非指的一個會話，即便請求的是同一個網址。好比：

1
2
3
4
5
6
7
8
9

import requests

requests. get ( 'http://httpbin.org/cookies/set/sessioncookie/123456789' )
r = requests. get ( "http://httpbin.org/cookies" )
print (r. text )
#結果是：
{
"cookies": { }
}

很明顯，這不在一個會話中，沒法獲取 cookies，那麼在一些站點中，咱們須要保持一個持久的會話怎麼辦呢？就像用一個瀏覽器逛淘寶同樣，在不一樣的選項卡之間跳轉，這樣其實就是創建了一個長久會話。
解決方案以下：

1
2
3
4
5
6
7
8
9
10
11
12

import requests

s = requests. Session ( )
s. get ( 'http://httpbin.org/cookies/set/sessioncookie/123456789' )
r = s. get ( "http://httpbin.org/cookies" )
print (r. text )
#在這裏咱們請求了兩次，一次是設置 cookies，一次是得到 cookies
{
"cookies": {
"sessioncookie": "123456789"
}
}

發現能夠成功獲取到 cookies 了，這就是創建一個會話到做用。

那麼既然會話是一個全局的變量，那麼咱們確定能夠用來全局的配置了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

import requests

s = requests. Session ( )
s. headers. update ( { 'x-test': 'true' } )
r = s. get ( 'http://httpbin.org/headers' , headers = { 'x-test2': 'true' } )
print r. text
'''經過 s.headers.update 方法設置了 headers 的變量。而後咱們又在請求中
設置了一個 headers，那麼會出現什麼結果？很簡單，兩個變量都傳送過去了。
運行結果:'''
{
"headers": {
"Accept": "*/*" ,
"Accept-Encoding": "gzip, deflate" ,
"Host": "httpbin.org" ,
"User-Agent": "python-requests/2.9.1" ,
"X-Test": "true" ,
"X-Test2": "true"
}
}

若是get方法傳的headers 一樣也是 x-test 呢？

1
2
3
4
5
6
7
8
9
10
11
12

r = s. get ( 'http://httpbin.org/headers' , headers = { 'x-test': 'true' } )

#它會覆蓋掉全局的配置：
{
"headers": {
"Accept": "*/*" ,
"Accept-Encoding": "gzip, deflate" ,
"Host": "httpbin.org" ,
"User-Agent": "python-requests/2.9.1" ,
"X-Test": "true"
}
}

若是不想要全局配置中的一個變量了呢？很簡單，設置爲 None 便可。

1
2
3
4
5
6
7
8
9

r = s. get ( 'http://httpbin.org/headers' , headers = { 'x-test': None } )
{
"headers": {
"Accept": "*/*" ,
"Accept-Encoding": "gzip, deflate" ,
"Host": "httpbin.org" ,
"User-Agent": "python-requests/2.9.1"
}
}

以上就是 session 會話的基本用法。

SSL證書驗證

如今隨處可見 https 開頭的網站，Requests能夠爲HTTPS請求驗證SSL證書，就像web瀏覽器同樣。要想檢查某個主機的SSL證書，你可使用 verify 參數，由於前段時間12306 證書不是無效的嘛，來測試一下：

1
2
3
4
5
6

import requests

r = requests. get ( 'https://kyfw.12306.cn/otn/' , verify = True )
print r. text
#結果：
requests. exceptions. SSLError: [SSL: CERTIFICATE_VERIFY_FAILED ] certificate verify failed (_ssl. c: 590 )

來試下 github 的：

1
2
3
4

import requests

r = requests. get ( 'https://github.com' , verify = True )
print r. text

嗯，正常請求，因爲內容太多，我就不粘貼輸出了。

若是咱們想跳過剛纔 12306 的證書驗證，把 verify 設置爲 False 便可：

1
2
3
4

import requests

r = requests. get ( 'https://kyfw.12306.cn/otn/' , verify = False )
print r. text

發現就能夠正常請求了。在默認狀況下 verify 是 True，因此若是須要的話，須要手動設置下這個變量。

代理

若是須要使用代理，你能夠經過爲任意請求方法提供 proxies 參數來配置單個請求

1
2
3
4
5
6
7
8
9
10

import requests

proxies = {
"https": "http://41.118.132.69:4433"
}
r = requests. post ( "http://httpbin.org/post" , proxies =proxies )
print r. text
#也能夠經過環境變量 HTTP_PROXY 和 HTTPS_PROXY 來配置代理
export HTTP_PROXY = "http://10.10.1.10:3128"
export HTTPS_PROXY = "http://10.10.1.10:1080"