函数
request(method, url, **kwargs): 发起指定方法的请求
head(url, **kwargs): 发送HEAD请求
get(url, params⑴=None, **kwargs): 发送GET请求
post(url, data⑵=None, json⑶=None, **kwargs): 发送POST请求
put(url, data⑵=None, **kwargs): 发送PUT请求
patch(url, data⑵=None, **kwargs): 发送PATCH请求
delete(url,**kwargs): 发送DELETE请求
kwargs参数
kwargs参数
⑴params:url查询参数
类型:字典类型 字节类型
字典类型:键-GET参数名 值-GET参数值,会自动拼接成查询字符串,如 {键1:值1,键2:值2,...}
字节类型:会被直接当作查询字符串拼接到URL后面,如 b'参数1=值1&参数2=值2...'
⑵data:请求体
类型:字典类型 元组列表 字节类型 文件对象
字典类型:格式为{POST参数名:POST参数值,...},会自动编码成表单数据(即application/x-www-form-urlencoded格式)
元组列表:格式为[(POST参数名, POST参数值),...],会自动编码成表单数据(即application/x-www-form-urlencoded格式)
字节类型:会被直接当成请求体,常用于发送原始的二进制数据
文件对象:常用于上传文件到服务器,会从文件对象中读取数据并发送到服务器
⑶json:请求体中的json
类型:数据,通常为字典或列表
注:数据会自动转化为json字符串,并将Content-Type设置为application/json
headers:请求头
类型:字典
字典类型:键-请求头字段名 值-字段值
cookies:设置请求携带的Cookie
类型:字典类型 CookieJar对象
字典类型:键-Cookie名 值-Cookie值
CookieJar对象:
files:请求体中的文件数据
类型:字典
字典类型:键-文件字段名 值-文件对象
proxies:设置代理
类型:字典
字典类型:键-协议(如http或https) 值-代理服务器url
其它kwargs参数
auth
timeout
allow_redirects
vertify
stream
cert
Response类
-- 属性 --
dict headers - 包含了响应头信息 (键-响应头名称,值-响应头值)
int status_code - 响应状态码
str reason - 响应状态码的文本描述
bool ok - 若响应状态码小于400,则值为True
str charset - 响应编码,若响应头Content-Type中charset值存在,则默认值为该值
str text - 响应体的Unicode字符串形式 (如果encoding未设置,则会使用chardet猜测编码)
bytes content - 响应体的字节形式
RequestsCookieJar cookies - 服务器返回的cookie
其它属性
apparent_encoding
elapsed
history
is_permanent_redirect
is_redirect
links
next
raw
reason
request
url
-- 方法 --
json(**kwargs)
close()
iter_content(chunk_size=1, decode_unicode=False)
iter_lines(chunk_size=512, decode_unicode=None, delimiter=None)
raise_for_status()
Session类
- 作用: 一个Sesson对象表示一个请求会话, 也会保持接收到的Cookie以发送下次请求
-- 构造方法 --
Session()
-- 方法 --
request(method, url, **kwargs): 发起指定方法的请求
head(url, **kwargs): 发送HEAD请求
get(url, params⑴=None, **kwargs): 发送GET请求
post(url, data⑵=None, json⑶=None, **kwargs): 发送POST请求
put(url, data⑵=None, **kwargs): 发送PUT请求
patch(url, data⑵=None, **kwargs): 发送PATCH请求
delete(url,**kwargs): 发送DELETE请求
options(url, **kwargs): 发送OPTIONS请求
其它方法
close()
get_adapter(url)
get_redirect_target(resp)
merge_environment_settings(url, proxies, stream, verify, cert)
mount(prefix, adapter)
prepare_request(request)
rebuild_auth(prepared_request, response)
rebuild_method(prepared_request, response)
rebuild_proxies(prepared_request, proxies)
resolve_redirects(resp, req, stream=False, timeout=None, verify=True, cert=None, proxies=None, yield_requests=False, **adapter_kwargs)
send(request, **kwargs)
-- 属性 --
RequestsCookieJar cookies - 包含了当前会话中所有未过期的Cookie
dict headers - 请求头,每个从该会话发送的请求都会携带(键-请求头字段 值-字段值)
dict params - url查询参数,每个从该会话发送的请求都会附加(键-参数名 值-参数值)
dict proxies - 代理,每个从该会话发送的请求都会使用(键-协议[如http或https] 值-代理服务器url)
其它属性
auth
cert
hooks
max_redirects
proxies
stream
trust_env
verify