Python requests介绍之接口介绍
Python requests介绍
引用官网介绍
Requests 唯一的一个非转基因的 Python HTTP 库,人类可以安全享用。
Requests 允许你发送纯天然,植物饲养的 HTTP/1.1 请求,无需手工劳动。你不需要手动为 URL 添加查询字串,也不需要对 POST 数据进行表单编码。Keep-alive 和 HTTP 连接池的功能是 100% 自动化的,一切动力都来自于根植在 Requests 内部的 urllib3。
功能特性
Requests 完全满足今日 web 的需求。
- Keep-Alive & 连接池
- 国际化域名和 URL
- 带持久 Cookie 的会话
- 浏览器式的 SSL 认证
- 自动内容解码
- 基本/摘要式的身份认证
- 优雅的 key/value Cookie
- 自动解压
- Unicode 响应体
- HTTP(S) 代理支持
- 文件分块上传
- 流下载
- 连接超时
- 分块请求
- 支持
.netrc
Requests 支持 Python 2.6—2.7以及3.3—3.7,而且能在 PyPy 下完美运行。
''' requests 接口介绍 '''
#-*-coding:utf-8-*- # Time:2017/10/12 22:54 # Author:YangYangJun #开始 requests学习之旅,这里直接在代码编写文字了。 #requests 是python的第三方库,所以这里需要安装 # 直接在命令行窗口执行 pip install requests 即可 #如果提示安装失败,可以参看提示,安装必备软件然后重新安装即可 #安装成功后 即可直接导入 import requests #如上不报错即可 #参考资料 #访问网址 http://cn.python-requests.org/zh_CN/latest/ 即可查看官方中文文档 #或是查看源代码 https://github.com/requests/requests #也可到 自己的安装目录下查找 D:/SProgram/Python/Lib/site-packages/requests/api.py 等文件查看介绍 ''' requests 接口介绍 ''' # 这部分文档包含了 Requests 所有的接口。对于 Requests 依赖的外部库部分,我们在这里介绍最重要的部分,并提供了规范文档的链接。 # # 主要接口 # Requests 所有的功能都可以通过以下 7 个方法访问。它们全部都会返回一个 Response 对象的实例。 # 1、request()方法 # requests.request(method, url, **kwargs) Constructs and sends a Request. 构造和发送请求。 # 这里的参数 method 、 url 是必选参数,**kwargs 是可选参数,是 可变关键字参数,Dictionary 类型 ''' 参数: method -- method for the new Request object. 新请求对象的方法 url -- URL for the new Request object. 新的请求对象的URL params -- (optional) Dictionary or bytes to be sent in the query string for the Request. (可选)在查询字符串中为请求发送的字典或字节。 data -- (optional) Dictionary or list of tuples [(key, value)] (will be form-encoded), bytes, or file-like object to send in the body of the Request. (可选)字典或元组列表[(键,值)](将以表单编码)、字节或类似文件的对象发送到请求体中。 json -- (optional) json data to send in the body of the Request. (可选)json数据发送到请求体中。 headers -- (optional) Dictionary of HTTP Headers to send with the Request. (可选)HTTP报头字典,以发送请求。 cookies -- (optional) Dict or CookieJar object to send with the Request. (可选)命令或CookieJar对象发送请求。 files -- (optional) Dictionary of 'name': file-like-objects (or {'name': file-tuple}) for multipart encoding upload. file-tuple can be a 2-tuple ('filename', fileobj), 3-tuple ('filename', fileobj, 'content_type') or a 4-tuple ('filename', fileobj, 'content_type', custom_headers), where 'content-type' is a string defining the content type of the given file and custom_headers a dict-like object containing additional headers to add for the file. 438/5000 (可选)“名称”的字典:文件- like- object(或{' name ':file - tuple}),用于多部分编码上传。文件- tuple可以是一个2元组(文件名,fileobj), 3元组(文件名,fileobj,' content_type ')或一个4元组(' filename ',fileobj,' content_type ',custom_headers), 其中' content-type '是一个字符串,它定义了给定文件的内容类型和custom_headers,其中包含了一个类似于dict的对象,其中包含了添加文件的附加头文件。 auth -- (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth. (可选)Auth tuple来启用Basic /Digest /自定义HTTP Auth。 timeout (float or tuple) -- (optional) How many seconds to wait for the server to send data before giving up, as a float, or a (connect timeout, read timeout) tuple. (可选)在放弃之前,等待服务器发送数据的时间是多少秒,作为一个浮点数,或者是一个(连接超时,读超时)元组。 allow_redirects (bool) -- (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to True. (可选)布尔。启用/禁用GET /选项/ POST / PUT /补丁/删除/头重定向。默认值为True。 proxies -- (optional) Dictionary mapping protocol to the URL of the proxy. (可选)字典映射协议到代理的URL。 verify -- (optional) Either a boolean, in which case it controls whether we verify the server's TLS certificate, or a string, in which case it must be a path to a CA bundle to use. Defaults to True. (可选)一个布尔值,在这种情况下,它控制我们是否验证服务器的TLS证书,或者是一个字符串,在这种情况下,它必须是一个到CA包使用的路径。默认值为True。 stream -- (optional) if False, the response content will be immediately downloaded. (可选)如果错误,将立即下载响应内容。 cert -- (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair. (可选)如果字符串,路径到ssl客户机cert文件(. pem)。如果是Tuple(' cert ',' key ')对。 ''' # request()方法实例 req = requests.request('GET', 'http://httpbin.org/get') print req # 得到 <Response [200]> # 2、head()方法 # requests.head(url, **kwargs) # Sends a HEAD request. 发送一个HEAD 请求。 # Optional arguments that ``request`` takes. 请求获取的可选参数。 r"""Sends a HEAD request. :param url: URL for the new :class:`Request` object. :param \*\*kwargs: Optional arguments that ``request`` takes. :return: :class:`Response <Response>` object :rtype: requests.Response """ # head()方法实例 req = requests.head('http://httpbin.org/get') print req # 得到 <Response [200]> # 3、get()方法 # requests.get(url, params=None, **kwargs)[源代码] # Sends a GET request. # # 参数: # url -- URL for the new Request object. # params -- (optional) Dictionary or bytes to be sent in the query string for the Request. # **kwargs -- Optional arguments that request takes. # 返回: # Response object # # 返回类型: # requests.Response # get()方法实例 req = requests.get('http://httpbin.org/get') print req # 得到 <Response [200]> # 4、post()方法 # requests.post(url, data=None, json=None, **kwargs)[源代码] # Sends a POST request. # # 参数: # url -- URL for the new Request object. # data -- (optional) Dictionary (will be form-encoded), bytes, or file-like object to send in the body of the Request. # json -- (optional) json data to send in the body of the Request. # **kwargs -- Optional arguments that request takes. # 返回: # Response object # # 返回类型: # requests.Response # post()方法实例 req = requests.post('http://httpbin.org/get') print req # 得到 <Response [405]> # 5、put()方法 # requests.put(url, data=None, **kwargs)[源代码] # Sends a PUT request. # # 参数: # url -- URL for the new Request object. # data -- (optional) Dictionary (will be form-encoded), bytes, or file-like object to send in the body of the Request. # json -- (optional) json data to send in the body of the Request. # **kwargs -- Optional arguments that request takes. # 返回: # Response object # # 返回类型: # requests.Response # 6、patch()方法 # requests.patch(url, data=None, **kwargs)[源代码] # Sends a PATCH request. # # 参数: # url -- URL for the new Request object. # data -- (optional) Dictionary (will be form-encoded), bytes, or file-like object to send in the body of the Request. # json -- (optional) json data to send in the body of the Request. # **kwargs -- Optional arguments that request takes. # 返回: # Response object # # 返回类型: # requests.Response # 7、delete()方法 # requests.delete(url, **kwargs)[源代码] # Sends a DELETE request. # # 参数: # url -- URL for the new Request object. # **kwargs -- Optional arguments that request takes. # 返回: # Response object # # 返回类型: # requests.Response #
![](http://files.cnblogs.com/files/BlueSkyyj/zfbd.bmp)
您的资助是我最大的动力!
金额随意,欢迎来赏!
![](http://files.cnblogs.com/files/BlueSkyyj/wxzf.bmp)
您的资助是我最大的动力!
金额随意,欢迎来赏!
如果,您希望更容易地发现我的新博客,不妨点击一下绿色通道的
因为,我的写作热情也离不开您的肯定与支持,感谢您的阅读,我是【Blue·Sky】!
【China-测试开发】技术交流群期待你的加入【 193056556 】
【欢迎扫码关注:日益】微信订阅号【 riyi18 】