个人中心
gpt4 book ai didi

python三方库之requests的快速上手

转载 作者：qq735679552 更新时间：2022-09-28 22:32:09 25 4
gpt4 key购买 nike

CFSDN坚持开源创造价值，我们致力于搭建一个资源共享平台，让每一个IT人在这里找到属于你的精彩世界.

这篇CFSDN的博客文章python三方库之requests的快速上手由作者收集整理，如果你对这篇文章有兴趣，记得点赞哟.

本文基于2.21.0 。

发送请求 。

发送GET请求:

?
1
r = requests.get( 'https://api.github.com/events' )

发送POST请求:

?
1
r = requests.post( 'https://httpbin.org/post' , data = { 'key' : 'value' })

其他请求接口与HTTP请求类型一致，如PUT, DELETE, HEAD, OPTIONS等.

在URL查询字符串中使用参数 。

给params参数传递一个字典对象:

?
1
2
3
4
>>> payload = { 'key1' : 'value1' , 'key2' : 'value2' }
>>> r = requests.get( 'https://httpbin.org/get' , params = payload)
>>> print (r.url)
https: / / httpbin.org / get?key2 = value2&key1 = value1

字典的值也可以是一个列表:

?
1
2
3
4
>>> payload = { 'key1' : 'value1' , 'key2' : [ 'value2' , 'value3' ]}
>>> r = requests.get( 'https://httpbin.org/get' , params = payload)
>>> print (r.url)
https: / / httpbin.org / get?key1 = value1&key2 = value2&key2 = value3

参数中值为None的键值对不会加到查询字符串 。

文本响应内容 。

Response对象的text属性可以获取服务器响应内容的文本形式，Requests会自动解码:

?
1
2
3
>>> r = requests.get( 'https://api.github.com/events' )
>>> r.text
'[{ "id" : "9167113775" , "type" : "PushEvent" , "actor" ...

访问Response.text时，Requests将基于HTTP头猜测响应内容编码。使用Response.encoding属性可以查看或改变Requests使用的编码:

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

二进制响应内容 。

Response对象的content属性可以获取服务器响应内容的二进制形式:

?
1
2
>>> r.content
b'[{ "id" : "9167113775" , "type" : "PushEvent" , "actor" ...

JSON响应内容 。

Response对象的json()方法可以获取服务器响应内容的JSON形式:

?
1
2
3
>>> r = requests.get( 'https://api.github.com/events' )
>>> r.json()
[{ 'repo' : { 'url' : 'https: / / api.github.com / ...

如果JSON解码失败，将抛出异常.

原始响应内容 。

在极少情况下，可能需要访问服务器原始套接字响应。通过在请求中设置stream=True参数，并访问Response对象的raw属性实现:

?
1
2
3
4
5
>>> r = requests.get( 'https://api.github.com/events' , stream = True )
>>> r.raw
<urllib3.response.HTTPResponse object at 0x101194810 >
>>> r.raw.read( 10 )
'\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\x03'

通常的用法是用下面这种方式将原始响应内容保存到文件，Response.iter_content方法将自动解码gzip和deflate传输编码:

?
1
2
3
with open (filename, 'wb' ) as fd:
   for chunk in r.iter_content(chunk_size = 128 ):
     fd.write(chunk)

定制请求头 。

传递一个dict对象到headers参数，可以添加HTTP请求头:

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

定制的header的优先级较低，在某些场景或条件下可能被覆盖.

所有header的值必须是string, bytestring或unicode类型。但建议尽量避免传递unicode类型的值 。

更复杂的POST请求 。

发送form-encoded数据 。

给data参数传递一个字典对象:

?
1
2
>>> payload = { 'key1' : 'value1' , 'key2' : 'value2' }
>>> r = requests.post( "https://httpbin.org/post" , data = payload)

如果有多个值对应一个键，可以使用由元组组成的列表或者值是列表的字典:

?
1
2
3
4
>>> payload_tuples = [( 'key1' , 'value1' ), ( 'key1' , 'value2' )]
>>> r1 = requests.post( 'https://httpbin.org/post' , data = payload_tuples)
>>> payload_dict = { 'key1' : [ 'value1' , 'value2' ]}
>>> r2 = requests.post( 'https://httpbin.org/post' , data = payload_dict)

发送非form-encoded数据 。

如果传递的是字符串而非字典，将直接发送该数据:

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

或者可以使用json参数自动对字典对象编码:

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

a) 如果在请求中使用了data或files参数，json参数会被忽略。b) 在请求中使用json参数会改变Content-Type的值为application/json 。

POST一个多部分编码(Multipart-Encoded)的文件 。

上传文件:

?
1
2
3
>>> url = 'https://httpbin.org/post'
>>> files = { 'file' : open ( 'report.xls' , 'rb' )}
>>> r = requests.post(url, files = files)

显式地设置文件名，内容类型(Content-Type)以及请求头:

?
1
2
3
>>> url = 'https://httpbin.org/post'
>>> files = { 'file' : ( 'report.xls' , open ( 'report.xls' , 'rb' ), 'application/vnd.ms-excel' , { 'Expires' : '0' })}
>>> r = requests.post(url, files = files)

甚至可以发送作为文件接收的字符串:

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

如果发送的文件过大，建议使用第三方包requests-toolbelt做成数据流.

强烈建议以二进制模式打开文件，因为Requests可能以文件中的字节长度来设置Content-Length 。

响应状态码 。

Response对象的status_code属性可以获取响应状态:

?
1
2
3
>>> r = requests.get( 'https://httpbin.org/get' )
>>> r.status_code
200

requests库还内置了状态码以供参考:

?
1
2
>>> r.status_code = = requests.codes.ok
True

如果请求异常(状态码为4XX的客户端错误或5XX的服务端错误)，可以调用raise_for_status()方法抛出异常:

?
1
2
3
4
5
6
7
8
>>> bad_r = requests.get( 'https://httpbin.org/status/404' )
>>> bad_r.status_code
404
>>> bad_r.raise_for_status()
Traceback (most recent call last):
  File "requests/models.py" , line 832 , in raise_for_status
   raise http_error
requests.exceptions.HTTPError: 404 Client Error

响应头 。

Response对象的headers属性可以获取响应头，它是一个字典对象，键不区分大小写:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
>>> r.headers
{
   'content-encoding' : 'gzip' ,
   'transfer-encoding' : 'chunked' ,
   'connection' : 'close' ,
   'server' : 'nginx/1.0.4' ,
   'x-runtime' : '148ms' ,
   'etag' : '"e1ca502697e5c9317743dc078f67693f"' ,
   'content-type' : 'application/json'
}
>>> r.headers[ 'Content-Type' ]
'application/json'
>>> r.headers.get( 'content-type' )
'application/json'

Cookies 。

Response对象的cookies属性可以获取响应中的cookie信息:

?
1
2
3
4
>>> url = 'http://example.com/some/cookie/setting/url'
>>> r = requests.get(url)
>>> r.cookies[ 'example_cookie_name' ]
'example_cookie_value'

使用cookies参数可以发送cookie信息:

?
1
2
3
>>> url = 'https://httpbin.org/cookies'
>>> cookies = dict (cookies_are = 'working' )
>>> r = requests.get(url, cookies = cookies)

Response.cookies返回的是一个RequestsCookieJar对象，跟字典类似但提供了额外的接口，适合多域名或多路径下使用，也可以在请求中传递:

?
1
2
3
4
5
6
7
>>> jar = requests.cookies.RequestsCookieJar()
>>> jar. set ( 'tasty_cookie' , 'yum' , domain = 'httpbin.org' , path = '/cookies' )
>>> jar. set ( 'gross_cookie' , 'blech' , domain = 'httpbin.org' , path = '/elsewhere' )
>>> url = 'https://httpbin.org/cookies'
>>> r = requests.get(url, cookies = jar)
>>> r.text
'{"cookies": {"tasty_cookie": "yum"}}'

重定向及请求历史 。

requests默认对除HEAD外的所有请求执行地址重定向。Response.history属性可以追踪重定向历史，它返回一个list，包含为了完成请求创建的所有Response对象并由老到新排序.

下面是一个HTTP重定向HTTPS的用例:

?
1
2
3
4
5
6
7
>>> r = requests.get( 'http://github.com/' )
>>> r.url
'https://github.com/'
>>> r.status_code
200
>>> r.history
[<Response [ 301 ]>]

使用allow_redirects参数可以禁用重定向:

?
1
2
3
4
5
>>> r = requests.get( 'http://github.com/' , allow_redirects = False )
>>> r.status_code
301
>>> r.history
[]

如果使用的是HEAD请求，也可以使用allow_redirects参数允许重定向:

?
1
2
3
4
5
>>> r = requests.head( 'http://github.com/' , allow_redirects = True )
>>> r.url
'https://github.com/'
>>> r.history
[<Response [ 301 ]>]

请求超时 。

使用timeout参数设置服务器返回响应的最大等待时间:

?
1
2
3
4
>>> requests.get( 'https://github.com/' , timeout = 0.001 )
Traceback (most recent call last):
  File "<stdin>" , line 1 , in <module>
requests.exceptions.Timeout: HTTPConnectionPool(host = 'github.com' , port = 80 ): Request timed out. (timeout = 0.001 )

错误及异常 。

  • ConnectionError：网络异常，比如DNS错误，连接拒绝等。
  • HTTPError：如果请求返回4XX或5XX状态码，调用Response.raise_for_status()会抛出此异常。
  • Timeout：连接超时。
  • TooManyRedirects：请求超过配置的最大重定向数。
  • RequestException：异常基类。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我.

原文链接：https://segmentfault.com/a/1190000018374275 。

最后此篇关于python三方库之requests的快速上手的文章就讲到这里了,如果你想了解更多关于python三方库之requests的快速上手的内容请搜索CFSDN的文章或继续浏览相关文章，希望大家以后支持我的博客！ 。

25 4 0
文章推荐： python中的np.argmax() 返回最大值索引号
文章推荐： C++结构体数组实现贪吃蛇
文章推荐： Python3 类型标注支持操作
文章推荐： C语言枚举(enum)和联合(union)实例分享
qq735679552
个人简介

我是一名优秀的程序员,十分优秀！

滴滴打车优惠券免费领取
滴滴打车优惠券
全站热门文章
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com