1、requests.get(url, params=None, headers=None, cookies=None, auth=None, timeout=None)
Sends a GET request. Returns Response object. 发送GET请求。 返回Response对象。
Parameters:
- url – URL for the new Request object. 请求对象的URL地址
- params – (optional) Dictionary of GET Parameters to send with the Request. (可选)使用字典作为GET请求的参数。
- headers – (optional) Dictionary of HTTP Headers to send with the Request. (可选)使用字典作为GET请求的headers信息。
- cookies – (optional) CookieJar object to send with the Request. (可选)使用CookieJar对象发送GET请求。
- auth – (optional) AuthObject to enable Basic HTTP Auth. (可选)AuthObject启用基本HTTP身份验证
- timeout – (optional) Float describing the timeout of the request. (可选)请求超时的设置,用浮点数表示。
2. requests.request() 方法参数
request() 源码中,对request() 传入三个参数 method, url, **kwargs,request() 方法构造参数并将信息发送给了Request(),
真正调用的路径:request(method, url, **kwargs) -> session.request(method=method, url=url, **kwargs) ->req = Request(method=method.upper(), url=url, headers=headers, files=files, data=data or {}, json=json, params=params or {}, auth=auth, cookies=cookies, hooks=hooks, )
Request() 方法对参数进行初始化后,返回给 req 对象。
request(method, url, **kwargs) 参数解释:
- method:新的Request 对象的请求方法
- url:新的Request 对象请求的地址
- **kwargs 可接受多个参数的表示,可能传入的参数有以下:
- params:可选,类型可以是 字典、元组列表或字节序列
- data:可选,类型可以是 字典,元组列表,字节,或文件对象,放在Request 请求的body正文中进行发送
- json:可选,一个JSON序列化的python对象,放在Request 请求的body正文中进行发送
- headers:可选,与 Request 请求一起发送的头部信息,字典类型
- cookies:可选,与 Request 请求一起发送的字典或CookieJar对象
- files:可选,文件对象,有多种组织形式,例如:字典,“name”: "name': file-like-objects" 或者 {'name': file-tuple},其中 file-tuple 可以是二元组('filename', fileobj)
或者三元组 ('filename', fileobj, 'content_type'), 或者四元组 ('filename', fileobj, 'content_type', custom_headers),,其中 content_type 是字符串,定义了文件内容和头部信息的类型。
- auth:可选,身份验证,以元组的形式传参,以启用基本/摘要/自定义的HTTP验证。
- timeout:可选,超时,在服务器响应之前进行等待,可以是一个浮点数,也可以用元组表示,如(5.1, 5.4),第一个是连接服务器的超时等待时间,第二个是读取的超时等待时间。
- allow_redirects:可选,布尔值,默认 True, 启用/禁用GET / OPTIONS / POST / PUT / PATCH / DELETE / HEAD重定向
- proxies:可选,字典类型,将协议与代理地址映射
- verify:(校验),可选,vefify 可以是布尔值,默认是 True,仅应用于主机证书,控制是否对服务器的TLS证书;也可以是字符串,这种情况下,verify 传入 CA_BUNDLE 文件的路径,或者包含可信任 CA 证书文件的文件夹路径。
- stream:可选,立即下载响应内容的开关,默认是 True,不打开。
- cert:可选,用来指定一个本地证书用作客户端证书,值可以是string类型,是为为ssl客户端证书文件(.pem)的路径(包含密钥和证书),
例如:requests.request('GET', "URL", cert='/wrong_path/client.pem' )
也可以是元组(包含两个文件的路径),格式如 requests.request('GET', 'URL', cert=('/path/client.cert', '/path/client.key'))
request 返回一个 Response 对象,requests.Response