requests.request
功能说明
描述
执行各种request方法,包含get、options、head、post、put、patch、delete。
- requests的方法符合http标准协议如下:
HTTP/1.1协议中共定义了八种方法(有时也叫“动作”)来表明Request-URI指定的资源的不同操作方式:
OPTIONS - 返回服务器针对特定资源所支持的HTTP请求方法。 也可以利用向Web服务器发送'*'的请求来测试服务器的功能性。
HEAD - 向服务器索要与GET请求相一致的响应,只不过响应体将不会被返回。 这一方法可以在不必传输整个响应内容的情况下,就可以获取包含在响应消息头中的元信息。
GET - 向特定的资源发出请求。 注意:GET方法不应当被用于产生“副作用”的操作中,例如在web app.中。 其中一个原因是GET可能会被网络蜘蛛等随意访问。
POST - 向指定资源提交数据进行处理请求(例如提交表单或者上传文件)。 数据被包含在请求体中。POST请求可能会导致新的资源的建立和/或已有资源的修改。
PUT - 向指定资源位置上传其最新内容。
DELETE - 请求服务器删除Request-URI所标识的资源。
TRACE - 回显服务器收到的请求,主要用于测试或诊断。
CONNECT - HTTP/1.1协议中预留给能够将连接改为管道方式的代理服务器。
- 更多详情请参见 官方文档
函数原型
requests.request(method,url,data=None,headers=None)
参数
名称 | 类型 | 描述 |
---|---|---|
method | 字符型 | 请求的方法名称(包含get、options、head、post、put、patch、delete) |
url | 字符型 | 网页地址 |
data | 数组:字典型 | 请求的数据 |
headers | 数组:字典型 | 请求头 |
其它扩展参数如下:
参数 | 解释 |
---|---|
method | 各种方法,比如get、options、head、post、put、patch、delete,当然也支持自定义扩展 |
url | 请求的url |
params | 请求携带的params |
data | 请求body中的data |
json | 请求body中的json格式的data |
headers | 请求携带的headers |
cookies | 请求携带的cookies |
files | 上传文件时使用 |
auth | 身份认证时使用 |
timeout | 设置请求的超时时间,可以设置连接超时和读取超时 |
allow_redirects | 是否允许重定向,默认True,即允许重定向 |
proxies | 设置请求的代理,支持http代理以及socks代理) |
verify | 用于https请求时的ssl证书验证,默认是开启的,如果不需要则设置为False即可 |
stream | 是否立即下载响应内容,默认是False,即立即下载响应内容 |
cert | 用于指定本地文件用作客户端证书 |
返回值
类型 | 描述 |
---|---|
对象型 | 执行成功返回http标准结果集,失败程序异常退出,错误信息请查看 <云应用运行错误.log> |
- 结果集的详细信息:
属性或属性方法 | 解释 |
---|---|
r.status_code | 响应的http状态码,比如404和200 |
r.headers | 响应头,可单独取出某个字段的值,比如(r.headers)['content-type'] |
r.raw | 原始响应,表示urllib3.response.HTTPResponse对象。使用raw时,要求在请求时设置“stream=True” |
r.url | 请求的最终地址 |
r.encoding | 要解码的r.text的编码方式 |
r.history | 请求的历史记录,可以用于查看重定向信息,以列表形式展示,排序方式是从最旧到最新的请求 |
r.reason | 响应状态的描述,比如"NotFound"or"OK" |
r.cookies | 服务器发回的cookies,RequestsCookieJar类型 |
r.elapsed | 从发送请求到响应到达之间经过的时间量,可以用于测试响应速度。比如r.elapsed.microseconds表示响应到达需要多少微秒 |
r.request | PreparedRequest对象,可以用于查看发送请求时的信息,比如r.request.headers查看请求头 |
r.ok | 检查”status_code“的值,如果小于400,则返回True,如果不小于400,则返回False |
r.is_redirect | 判断是否重定向,返回TrueorFalse |
r.is_permanent_redirect | 判断是否永久重定向,返回TrueorFalse |
r.next | 返回重定向链中下一个请求的PreparedRequest对象 |
r.apparent_encoding | 用chardet库判断出的编码方式 |
r.content | 响应的内容,byte类型 |
r.text | 响应的内容,unicode类型 |
r.links | 响应的解析头链接 |
备注
- 无
示例
def test():
data={
'name':'zhangsan',
'age':'25'
}
headers={
"Accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
"Accept-Language":"zh",
"Cache-Control":"max-age=0",
"Connection":"keep-alive",
"Cookie":"PHPSESSID=m2hbrvp548cg6v4ssp0l35kcj7; _ga=GA1.2.2052701472.1532920469; _gid=GA1.2.1351314954.1532920469; __atuvc=3%7C31; __atuvs=5b5e9a0418f6420c001",
"Host":"en.artprecium.com",
"Upgrade-Insecure-Requests":"1",
"User-Agent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/67.0.3396.99 Safari/537.36",
}
# 执行get请求
result=requests.request(method="get",url="https://api.xxx.com",params=data)
print(result)
# 执行post请求
result=requests.request(method="post",url="https://api.xxx.com",data=data,headers=headers)
print(result)
# 打印状态码
print(result.status_code)
# 打印页面内容
result.encoding='utf-8' #指定编码格式,仅支持utf-8
print(result.text)
# 打印cookies
print(result.cookies)
演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无