一、安装Requests
pip install requests
二、发送请求与传递参数
带参数请求:
import requests
requests.get('http://www.dict.baidu.com/s', params={'wd': 'python'}) #GET参数实例
requests.post('http://www.itwhy.org/wp-comments-post.php', data={'comment': '测试post'}) #POST参数实例
POST发送JSON数据:
import requests
impoet json
r = requests.post('https://api.github.com/some/endpoint', data=json.dumps({'some': 'data'}))
print(r.json())
定制header:
import requests
import json
data = {'some': 'data'}
headers = {'content-type': 'application/json',
'User-Agent': 'Mozilla/5.0(x11; Ubuntu; Linux x86_64; rv:22.0) GEcko/20100101
firefox/22.0'}
r = request.post('https://api.github.com/some/endpoint', data=data, headers=headers)
print(r.text)
三、Response对象
使用requests方法后,会返回一个response对象,其存储了服务器响应的内容。
r.status_code 响应状态码
r.raw 返回原始响应体
r.content 字节方式的响应体,会自动为你解码gzip和deflate压缩
r.text 字符串方式的响应体,会自动根据响应头部的字符编码进行解码
r.headers 以字典对象存储服务器的响应头,但是这个字典比较特殊,字典键不区分大小写,若键不存在返回None
特殊方法
r.json() Requests中内置JSON解码器
r.raise_for_starus() 失败请求抛出异常
例:
import requests
URL = 'http://ip.taobao.com/service/getIpinfo.php' #淘宝IP地址库API
try:
r = requests.get(URL, params={'ip': '8.8.8.8'}, timeout=1)
r.raise_for_status() #如果状态码不是200,就主动抛出异常
except requests.RequestException as e:
print(e)
else:
result = r.json()
print(type(result), result, sep='\n')
四、上传文件
使用Requests模块,上传文件也是如此简单的,文件的类型会自动进行处理:
import requests
url = 'http://127.0.0.1:8080/upload'
files = {'file': open('/home/lyb/sjzl.mpg', 'rb')}
# files = {'file': ('xxxx,jpg', open('/home/lyb/sjzl.mpg', 'rb'))} #设置文件名
r = requests.post(url, files = files)
print(r.text)
直接把字符串当文件进行上传:
import requests
url = 'http://127.0.0.1:5000/upload'
files = {'file':('test.txt', b'Hello Requests.')}
r = requests.post(url, files=files)
print(r.text)
五、身份验证
基本身份认证(HTTP Basic Auth):
import requests
from requests.auuth import HTTPBasicAuth
r = requests.get('https://httpbin.org/hidden-basic-auth/user/passwd', auth=HTTPBasicAuth('user', 'passwd'))
# r = requests.get('https://httpbin.org/hidden-basic-auth/user/passwd', auth=('user', 'passwd')) #简写
print(r.json())
摘要式身份认证
requests.get(URL, auth = HTTPDigestAuth('user', 'pass'))
六、Cookies与会话对象
发送cookies到服务器,携带cookies参数:
import requests
cookies = {'testCookies': 'Hello'}
r = requests.get('http://www.google.com' cookies = cookies)
print(r.json())
七、超时与异常
timeout 仅对连接过程有效,与响应体的下载无关。
requests.get('http://githhub.com', timeout=0.001)
所有Requests显式抛出的异常都继承自 requests.exceptions.RequestException:ConnectionError、HTTPError、TimeoutTooManyRedirects