python-requests快速入门

Pythonrequests快速入门迫不及待了吗？本页内容为如何入门Requests提供了很好的指引。其假设你已经安装了Requests。如果还没有，去安装一节看看吧。首先，确认一下：Requests已安装Requests是最新的让我们从一些简单的示例开始吧。发送请求使用Requests发送网络请求非常简单。一开始要导入Requests模块:importrequests然后，尝试获取某个网页。本例子中，我们来获取Github的公共时间线r=requests.get(')现在，我们有一个名为r的Response对象。可以从这个对象中获取所有我们想要的信息。Requests简便的API意味着所有HTTP请求类型都是显而易见的。例如，你可以这样发送一个HTTPPOST请求:r=requests.post()漂亮，对吧？那么其他HTTP请求类型：PUT，DELETE，HEAD以及OPTIONS又是如何的呢？都是一样的简单:r=requests.put()r=requests.delete()r=requests.head()r=requests.options()都很不错吧，但这也仅是Requests的冰山一角呢。为URL传递参数你也许经常想为URL的查询字符串(querystring)传递某种数据。如果你是手工构建URL，那么数据会以键/值对的形式置于URL中，跟在一个问号的后面。例如，httpbin.org/get?key=val。Requests允许你使用params关键字参数，以一个字典来提供这些参数。举例来说，如果你想传递key1=value1和key2=value2到httpbin.org/get，那么你可以使用如下代码:payload={'key1':'value1','key2':'value2'}r=requests.get(=payload)通过打印输出该URL，你能看到URL已被正确编码:printr.urlu'=value2&key1=value1'响应内容我们能读取服务器响应的内容。再次以Github时间线为例:importrequestsr=requests.get(')r.text'[{repository:{open_issues:0,url:会自动解码来自服务器的内容。大多数unicode字符集都能被无缝地解码。请求发出后，Requests会基于HTTP头部对响应的编码作出有根据的推测。当你访问r.text之时，Requests会使用其推测的文本编码。你可以找出Requests使用了什么编码，并且能够使用r.encoding属性来改变它:r.encoding'utf-8'r.encoding='ISO-8859-1'如果你改变了编码，每当你访问r.text，Request都将会使用r.encoding的新值。在你需要的情况下，Requests也可以使用定制的编码。如果你创建了自己的编码，并使用codecs模块进行注册，你就可以轻松地使用这个解码器名称作为r.encoding的值，然后由Requests来为你处理编码。二进制响应内容你也能以字节的方式访问请求响应体，对于非文本请求:r.contentb'[{repository:{open_issues:0,url:会自动为你解码gzip和deflate传输编码的响应数据。例如，以请求返回的二进制数据创建一张图片，你可以使用如下代码:fromPILimportImagefromStringIOimportStringIOi=Image.open(StringIO(r.content))JSON响应内容Requests中也有一个内置的JSON解码器，助你处理JSON数据:importrequestsr=requests.get(')r.json()[{u'repository':{u'open_issues':0,u'url':'如果JSON解码失败，r.json就会抛出一个异常。原始响应内容在罕见的情况下你可能想获取来自服务器的原始套接字响应，那么你可以访问r.raw。如果你确实想这么干，那请你确保在初始请求中设置了stream=True。具体的你可以这么做:r=requests.get('=True)r.rawrequests.packages.urllib3.response.HTTPResponseobjectat0x101194810r.raw.read(10)'\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\x03'定制请求头如果你想为请求添加HTTP头部，只要简单地传递一个dict给headers参数就可以了。例如，在前一个示例中我们没有指定content-type:importjsonurl='={'some':'data'}headers={'content-type':'application/json'}r=requests.post(url,data=json.dumps(payload),headers=headers)更加复杂的POST请求通常，你想要发送一些编码为表单形式的数据—非常像一个HTML表单。要实现这个，只需简单地传递一个字典给data参数。你的数据字典在发出请求时会自动编码为表单形式:payload={'key1':'value1','key2':'value2'}r=requests.post(=payload)printr.text{...form:{key2:value2,key1:value1},...}很多时候你想要发送的数据并非编码为表单形式的。如果你传递一个string而不是一个dict，那么数据会被直接发布出去。例如，GithubAPIv3接受编码为JSON的POST/PATCH数据:importjsonurl='={'some':'data'}r=requests.post(url,data=json.dumps(payload))POST一个多部分编码(Multipart-Encoded)的文件Requests使得上传多部分编码文件变得很简单:url='={'file':open('report.xls','rb')}r=requests.post(url,files=files)r.text{...files:{file:censored...binary...data},...}你可以显式地设置文件名:url='={'file':('report.xls',open('report.xls','rb'))}r=requests.post(url,files=files)r.text{...files:{file:censored...binary...data},...}如果你想，你也可以发送作为文件来接收的字符串:url='={'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},...}响应状态码我们可以检测响应状态码:r=requests.get(')r.status_code200为方便引用，Requests还附带了一个内置的状态码查询对象:r.status_code==requests.codes.okTrue如果发送了一个失败请求(非200响应)，我们可以通过Response.raise_for_status()来抛出异常:bad_r=requests.get(')bad_r.status_code404bad_r.raise_for_status()Traceback(mostrecentcalllast):Filerequests/models.py,line832,inraise_for_statusraisehttp_errorrequests.exceptions.HTTPError:404ClientError但是，由于我们的例子中r的status_code是200，当我们调用raise_for_status()时，得到的是:r.raise_for_status()None一切都挺和谐哈。响应头我们可以查看以一个Python字典形式展示的服务器响应头:r.headers{'status':'200OK','content-encoding':'gzip','transfer-encoding':'chunked','connection':'close','server':'nginx/1.0.4','x-runtime':'148ms','etag':'e1ca502697e5c9317743dc078f67693f','content-type':'application/json;charset=utf-8'}但是这个字典比较特殊：它是仅为HTTP头部而生的。根据RFC2616，HTTP头部是大小写不敏感的。因此，我们可以使用任意大写形式来访问这些响应头字段:r.headers['Content-Type']'application/json;charset=utf-8'r.headers.get('content-type')'application/json;charset=utf-8'如果某个响应头字段不存在，那么它的默认值为Noner.headers['X-Random']NoneCookies如果某个响应中包含一些Cookie，你可以快速访问它们:url='=requests.get(url)r.cookies['example_cookie_name']'example_cookie_value'要