Python Requests模块快速入门

requests是python的一个HTTP客户端库,跟urllib,urllib2类似。它比 urllib 更加方便,可以节约我们大量的工作,它比 urllib 更加 Pythoner。

安装 Requests

通过pip安装

$ pip install requests

或者,下载代码后安装:

$ wget https://github.com/requests/requests/tarball/master
$ mv master requests.tgz
$ tar xzf requests.tgz
$ cd requests-requests-3dc84cd
$ python setup.py install

发送请求

使用Requests发送网络请求非常简单。

>>> import requests #导入Requests模块
>>> result = requests.get('http://www.pythontab.com') # 生成Response 对象
>>> result.status_code  # 返回码 
200
>>> result.headers['content-type']  # 返回头部信息
'text/html; charset=utf8'
>>> result.encoding  # 编码信息
'utf-8'
>>> result.content  #内容部分


为URL传递参数

你也许经常想为URL的查询字符串(query string)传递某种数据。如果你是手工构建URL,那么数据会以键/值 对的形式置于URL中,跟在一个问号的后面。例如,www.pythontab.com?version=python3 。 Requests允许你使用 params 关键字参数,以一个字典来提供这些参数。举例来说,如果你想传递 version=python3 和 keywords=pythontab 到 www.pythontab.com ,那么你可以使用如下代码:

>>> data = {'version': 'python3', 'keywords': 'pythontab'}
>>> result = requests.get("http://www.pythontab.com", params=data)
>>> print result.status_code
200

原始响应内容

在罕见的情况下你可能想获取来自服务器的原始套接字响应,那么你可以访问 r.raw 。 如果你确实想这么干,那请你确保在初始请求中设置了 stream=True 。具体的你可以这么做:

>>> result = requests.get('http://www.pythontab.com', stream=True)
>>> result.raw
<requests.packages.urllib3.response.HTTPResponse object at 0x101194810>
>>> result.raw.read(10)
'\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\x03'

定制请求头

如果你想为请求添加HTTP头部,只要简单地传递一个 dict 给 headers 参数就可以了。

例如,在前一个示例中我们没有指定content-type:

>>> import requests
>>> url = 'http://www.pythontab.com'
>>> data = {'version': 'python3', 'keywords': 'pythontab'}
>>> headers = {'content-type': 'application/json'}
>>> result = requests.post(url, data=json.dumps(data), headers=headers)

错误与异常

遇到网络问题(如:DNS查询失败、拒绝连接等)时,Requests会抛出一个ConnectionError 异常。

遇到罕见的无效HTTP响应时,Requests则会抛出一个 HTTPError 异常。

若请求超时,则抛出一个 Timeout 异常。

若请求超过了设定的最大重定向次数,则会抛出一个 TooManyRedirects 异常。

所有Requests显式抛出的异常都继承自 requests.exceptions.RequestException 。


其他常用方法

result.content #获取二进制响应内容

result.json()  #JSON响应内容

result.headers #响应头内容

result.cookies #cookie内容

result.history #请求历史


PythonTab微信公众号:

Python技术交流互助群 ( 请勿加多个群 ):

群1: 87464755

群2: 333646237

群3: 318130924

群4: 385100854

相关词搜索:模块 Requests

上一篇:除法运算符/在Python2和Python3中的区别
下一篇:Python3和Python2 异常处理except的不同