Python requests介绍之接口介绍

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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
#

 

以上是关于Python requests介绍之接口介绍的主要内容,如果未能解决你的问题,请参考以下文章

Python接口自动化-requests模块之post请求

python自动化测试三部曲之request+django实现接口测试

python-爬虫之requests模块介绍(登陆github)

Python接口自动化-requests模块之get请求

Python接口自动化之浅析requests模块get请求

Python接口自动化之浅析requests模块get请求