目录
- 安装 Reuqests
- HTTP 简介
- 什么是 HTTP
- HTTP工作原理
- HTTP的9种请求方法
- HTTP状态码
- requests 快速上手
- requests 发起请求的步骤
- requests 发起请求的两种方式
- 请求参数
- 发起 GET 请求
- 发起 POST 请求
- requests 实战
- 登录接口的测试
- 获取用户信息接口的测试
- 对响应结果的处理(序列化和反序列化)
Requests 是一个 Python 的一个第三方库,通过发送 HTTP 请求获取响应数据,一般应用于编写网络爬虫和接口测试等。
相比 urllib 库,它语法简单,更容易上手。
官方中文文档地址:Requests: 让 HTTP 服务人类
离线文档下载地址:Requests document download
安装 Reuqests
pip install requests
HTTP 简介
在使用 requests 模拟发送网络请求之前,先来简单学习一下HTTP和常见的请求方式。
什么是 HTTP
HTTP(HyperText Transfer Protocol ,超文本传输协议)是一个简单的请求/响应协议。即一个客户端与服务器建立连接后,向服务器发送一个请求;服务器接到请求后,给予相应的响应信息。
HTTP工作原理
1.客户端与服务器端建立连接
2.客户端向服务器端发起请求
3.服务器接受请求,并根据请求返回相应的内容
4.客服端与服务器端连接关闭
客户端和服务器端之间的HTTP连接是一种一次性连接,它限制每次连接只处理一个请求,当服务器返回本次请求的应答后便立即关闭,下次请求再重新建立连接。这样做的好处就是让服务器不会处于一个一直等待的状态,及时释放连接可极大提高服务器的执行效率。
HTTP是一种无状态协议,意思就是服务器不保留与客户端连接时的任何状态。这减轻了服务器的记忆负担,从而保持较快的响应速度。
HTTP的9种请求方法
每种请求方式规定了客户端和服务器端之间不同的信息交换方式。
请求方法 | 描述 |
---|---|
GET | 请求指定的页面信息,并返回实体主体。 |
POST | 向指定资源提交数据进行处理请求(例如提交表单或者上传文件)。数据被包含在请求体中。POST请求可能会导致新的资源的建立或已有资源的修改。 |
HEAD | 类似于 GET 请求,只不过返回的响应中没有具体的内容,用于获取报头 |
PUT | 从客户端向服务器传送数据取代指定的文档的内容。 |
PATCH | 是对 PUT 方法的补充,用来对已知资源进行局部更新 |
DELETE | 请求服务器删除指定的页面 |
OPTIONS | 允许客户端查看服务器的性能 |
TRACE | 回显服务器收到的请求,主要用于测试或诊断 |
CONNECT | HTTP/1.1 协议中预留给能够将连接改为管道方式的代理服务器 |
请求方法GET和POST的区别:
- GET提交的数据会放在URL之后,以?分割URL和传输数据,参数之间以&相连,如EditPosts.aspx?name=test1&id=123456. POST方法是把提交的数据放在HTTP包的Body中
- GET提交的数据大小有限制(因为浏览器对URL的长度有限制),而POST方法提交的数据没有限制
- GET方式需要使用Request.QueryString来取得变量的值,而POST方式通过Request.Form来获取变量的值。
- GET方式提交数据,会带来安全问题,比如一个登录页面,通过GET方式提交数据时,用户名和密码将出现在URL上,如果页面可以被缓存或者其他人可以访问这台机器,就可以从历史记录获得该用户的账号和密码
HTTP状态码
状态代码有三位数字组成,第一个数字定义了响应的类别,共分五种类别:
分类 | 分类描述 |
---|---|
1** | 指示信息–服务器收到请求,需要请求者继续执行操作 |
2** | 成功–操作被成功接收并处理 |
3** | 重定向–需要进一步的操作以完成请求 |
4** | 客户端错误–请求包含语法错误或无法完成请求 |
5** | 服务器错误–服务器在处理请求的过程中发生了错误 |
常见的状态码:
状态码 | 含义 |
---|---|
200 OK | 客户端请求成功 |
400 Bad Request | 客户端请求有语法错误,不能被服务器理解 |
401 Unauthorized | 请求未经授权,这个状态码必须和 WWW-Authenticate 报头域一起使用 |
403 Forbidden | 服务器收到请求,但是拒绝服务 |
404 Not Found | 请求资源不存在,eg:输入了错误的URL |
500 Internal Server Error | 服务器发生不可预期的错误 |
503 Server Unavailable | 服务器当掐你不能处理客户端的请求,一段时间后可能恢复 |
本节参考链接:
https://www.cnblogs.com/qdhxhz/p/8468913.html
https://blog.csdn.net/qq_40100414/article/details/120122782
如果你想学习关于 HTTP 的更多知识,可以关注公众号[愿泽君],输入”python requests”获取高清电子书和本文 markdown 笔记。
requests 快速上手requests 发起请求的步骤
使用 requests 的流程大致可以分为以下三步:
graph LRid1(填写method url params等参数)–>id2(发起请求)–>id3(查看响应结果)requests 发起请求的两种方式
使用 requests 发起请求有两种方式,以发起post请求为例:
import requests# 方式一:r = requests.request("post","https://www.baidu.com")print(r.text)# 方式二:r = requests.post("https://www.baidu.com")print(r.text)
requests.request(method, url, ...)
的 request 是 requests 封装好根据 method 传参的不同而调用对应的请求方法。method 参数的值可以是 get/post/put/delete/head/patch/options 等,对应我们上一节的 HTTP 请求方法。上面的示例代码中方式一和方式二达到的效果都是一样的,但是推荐使用方式一,因为在后面的接口自动化测试中便于参数化,如下:
import requestsmethod = "get"url = "https://www.baidu.com"r = requests.request(method=method, url=url)print(r.text)
请求参数
requests 发起请求时,支持传递的参数列表:
- method:请求的类型,格式为字符串。值可以是 get\post\put\delete\files\head\patch\options
- url:请求的接口地址,格式为字符串。此参数必传
- params: get类型的接口请求的数据,格式为字典
- data:form-data 一般用于 post 类型的接口请求的数据,格式为字典/json/字符串
- json: json格式的参数,格式为字典
- headers:请求头,格式为字典
- cookies:格式为字典
- files:上传文件,格式为字典
- timeout:请求超时时间,float
- allow_redirects:是否支持重定向,格式为boolean
- verify:是否忽略http协议的证书错误,boolean:True 不忽略
在接下来的案例我们会逐一对上面的参数进行详细讲些。
发起 GET 请求
使用 Requests 模拟发送 GET 请求,以请求百度首页为例:
# 导入requests库import requests# 要请求的地址url = "http://www.baidu.com"# 发起 GET 请求,并将响应结果存储在 res 中,res是一个 responses 对象res = requests.get(url)print(res.request.headers)# 查看请求头信息print(res.request.body)# 查看请求正文print(res.request.url)# 查看请求urlprint(res.request.method)# 查看请求方法print(res.content)# 响应结果的字节码格式,一般用于图片,视频数据等print(res.encoding)# 查看响应正文的编码格式print(res.text)# 响应结果的字符串格式,非字节码print(res.status_code)# 响应结果状态码,200 表示成功print(r.reason)# 响应状态码的描述信息,如 OK,NotFound 等print(res.cookies)# 获取 cookiesprint(res.headers)# 查看响应的响应头print(res.url)# 查看响应的url
如果响应内容中文显示是乱码,在此提供2种解决方案:
import requestsurl = "http://www.baidu.com"res = requests.get(url)# 方案1:res.encoding="utf-8"# 如果 res.text 中有中文乱码,修改编码格式为 "utf-8"print(res.text)# 方案2:res.content.decode("utf-8")# 将响应结果的字节码格式转换为 "utf-8" 格式print(res.text)
1)发起携带参数的 GET 请求
来看一下 Request 中 get 方法的定义:
def get(url, params=None, **kwargs): return request("get", url, params=params, **kwargs)
这意味着发起 GET 请求时,允许我们使用 params 关键字参数,参数的类型为字典(dict)。接下来看一个案例:
慕课网(https://www.imooc.com/)首页搜索 “python”,按 F12 –> 点击 NetWork 抓包获取其接口。
我们得到的接口部分信息如下:
请求方式:get请求url:https://www.imooc.com/search/coursesearchconditions?words=python
?words=python
问号后面的 word=python
就是我们在发起 get 请求时的要提供的参数,接下来使用 requests 来发起请求:
import requests# 慕课网首页课程查询接口url = "https://www.imooc.com/search/coursesearchconditions"# 查询时携带的参数payload = { 'words': 'python'}res = requests.get(url, params=payload)# 发起携带参数的 get 请求print(res.json())# 响应内容是 json 格式的字符串,我们使用 res.json() 方法进行解码
2)定制请求头
如果你想为请求添加 HTTP 头部,只需要传递一个字典(dict)给 headers 参数即可。例如,我们发起请求时要传递一个 UA(User-Agent)。User-Agent 中文名为用户代理,是Http协议中的一部分。它可以向访问网站提供你所使用的浏览器类型及版本、操作系统及版本、浏览器内核、等信息的标识。通过这个标 识,用户所访问的网站可以显示不同的排版从而为用户提供更好的体验或者进行信息统计。
为什么要添加 UA?
在使用 Python 的 Requests 模拟浏览器向服务器发送 Http 请求时,于某些网站会设置对 User-Agent 反爬虫机制,因此我们发送 Http 请求时有必要的加上 User-Agent
来将爬虫程序的UA伪装成某一款浏览器的身份标识。
import requestsurl = "https://www.imooc.com/search/coursesearchconditions"headers = {'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36'}# 查询时携带的参数payload = { 'words': 'python'}res = requests.get(url, params=payload, headers=headers)print(res.json())# 响应内容是 json 格式的字符串,我们使用 res.json() 方法进行解码print(res.request.headers) # 查看请求头
关于 Header 伪装策略的更多知识请参考以下博文:
- https://blog.csdn.net/weixin_38950569/article/details/105231122
- https://blog.csdn.net/ShyLoneGirl/article/details/117297325
发起 POST 请求
1)传递 data 参数
当我们要向网页上的一些表单(form)传递数据时,经常需要发起 post 请求。使用 requests 发起 post 请求的方法也非常简单,只需要传递一个字典给 data 参数。
import requestsurl = 'http://httpbin.org/post'payload = {'name': 'joy', 'phone': '400-7865-6666'}r = requests.post(url=url, data=payload)print(r.text)
运行结果:
{ ... "form": { "key2": "value2", "key1": "value1" }, ...}
还可以为 data 参数传入一个元组列表。例如表单中多个元素使用同一个 key 时,可以像下面这样做:
import requestsurl = 'http://httpbin.org/post'payload = (('course', 'Python'), ('course', 'Java'))r = requests.post(url=url, data=payload)print(r.text)
响应结果:
{ ... "form": { "course": [ "Python", "Java" ] }, ...}
当你想用 data 参数去接收 json 格式的数据,那么需要把请求的数据转换成 json 格式,并且要将请求头设置为 application/json
。
import requests, jsonurl = 'https://api.github.com/some/endpoint'data = json.dumps({ "some": "data"})headers = {"Content-Type":"application/json"}r = requests.post(url, data=data, headers=headers)print(r.text)
2) 传递json参数
可以使用 json
参数直接传递,然后它就会被自动编码
import requests, jsonurl = "http://119.45.233.102:6677/testgoup/test/json"data = { 'name': 'jay', 'age': 23}r = requests.post(url,json=data)print(r.text)
这里科普一下 json 和 dict(字典)的区别:
(1)字典是一种数据结构,是python中的一种数据类型;它是一种可变类型,可以存储任意类型的数值,以 key:value 的形式存储数据,但是 key 可以是任意可hash的对象 ,在一个字典中不允许出现两个相同的key值,如果出现,后面一个key值会覆盖前面的key值。
(2)Json是一种打包的数据格式,本质上是字符串,也是按照 key:value 来存储数据,key 只能时字符串,且可以有序、重复;必须使用双引号作为key或者值的边界符,不能使用单引号,使用单引号或者不使用引号会使解析错误。可以被解析为字典或者其他形式。
(3)json.loads函数的使用,将字符串转化为字典
import jsona = {'a': '1', 'b': '2', 'c': '3' }print(type(a)) # 输出 b = json.loads('{"age": "12"}') # 参数是str行,loads之后,变成dict字典了print(b) # 输出 {'age': '12'}print(type(b)) # 输出
(4)json.dumps()函数的使用,将字典转化为字符串
import json # json.dumps()函数的使用,将字典转化为字符串dict1 = {"age": "12"}json_info = json.dumps(dict1)print("dict1的类型:"+str(type(dict1)))print("通过json.dumps()函数处理:")print("json_info的类型:"+str(type(json_info)))
本部分参考来源:字典和Json的区别
3)传递 from-data 参数:
注意,requests默认是不支持from-data的请求数据的格式的。所以我们要传from-data格式,我们需要安装一个requests的插件:
pip install requests_toolbelt -i https://pypi.douban.com/simple
import requestsfrom requests_toolbelt.multipart.encoder import MultipartEncodermethod = "post"url = "http://119.45.233.102:6677/testgoup/test/data"data = MultipartEncoder({ "name":"张三", "age":"23"})headers = {"Content-Type":data.content_type}r = requests.request(method,url,data=data,headers=headers)print(r.text)
4)传递 auth 参数
auth是一种对接口进行鉴权的方式,和cookies和token的作用差不多的。格式:元组,比如:(“账号”,“密码”)
import requestsurl = "http://119.45.233.102:6677/testgoup/test/auth"method = "post"auth = ("admin","123456")r = requests.request(method,url,auth=auth)print(r.text)
5)传递 timeout 参数
timeout用于控制响应的时间,如果超过了timeout规定的时间,那么会直接抛出连接失败的错误信息。timeout格式是整数,单位是秒。
import requestsmethod = "post"url = "http://119.45.233.102:6677/testgoup/test/json"data = { "name":"张三", "age":23}r = requests.request(method,url,json=data,timeout=10)print(r.text)
6)传递 allow_redirects 参数
是否允许接口重定向。格式:布尔值
7)传递 proxies 参数
在编写爬虫程序时,同一个IP频繁对网站进行访问,可能会被封IP,为了避免这种情况我们就需要用到 proxies 参数来设置代理。proxies 参数可以将代理地址替换为你的IP地址,隐藏自身IP。
proxies 参数类型
proxies = { '协议':'协议://IP:端口号' }proxies = { 'http':'http://IP:端口号', 'https':'https://IP:端口号',}
可以去网上搜索免费的代理IP网站中查找免费代理IP(注意:如果获取到的免费IP地址无效就会报错):
# 使用免费普通代理IP访问测试网站: http://httpbin.org/getimport requestsurl = 'http://httpbin.org/get'headers = {'User-Agent':'Mozilla/5.0'}# 定义代理,在代理IP网站中查找免费代理IPproxies = { 'http':'http://182.116.239.37:9999', 'https':'https://182.116.239.37:9999'}html = requests.get(url,proxies=proxies,headers=headers,timeout=5).textprint(html)
这里推荐几个免费代理网站,可自行尝试:
- http://www.66ip.cn/
- https://www.kuaidaili.com/free/inha
本部分参考来源:关于代理参数-proxies那些事
8)传递 verify 参数
当我们请求https协议的接口的时候,如果它的证书过期了,我们就可以使用这个参数verify,设置为Fasle不检查证书,忽略证书的问题,继续请求。
本部分参考来源:requests从入门到精通
requests 实战登录接口的测试
TGU登录接口测试,登录接口信息如下:
地址:http://119.45.233.102:2244/testgoup/login类型:post请求头:application/json请求参数:{ "phone": "133********", "password": "e10adc3949ba59abbe56e057f20f883e", "type": 1}返回值:{ "code": 1, "data": { "nickName": "liuyanzu666", "token": "eyJ..." }, "message": "登录成功!"}
使用requests测试登录接口:
import requestsloginUrl = 'http://119.45.233.102:2244/testgoup/login'method='post'data = { "phone": "133********", "password": "e10adc3949ba59abbe56e057f20f883e", "type": 1}r = requests.request(method=method, url=loginUrl, json=data)print(r.text)
获取用户信息接口的测试
由于需要登录后才能获取到用户信息,在获取用户信息时需要传入登录后返回的token。完整代码如下:
import requestsloginUrl = 'http://119.45.233.102:2244/testgoup/login'method='post'data = { "phone": "133********", "password": "e10adc3949ba59abbe56e057f20f883e", "type": 1}#登录接口r = requests.request(method=method, url=loginUrl, json=data)# print(r.text)token = r.json()['data']['token']# 获取用户信息接口userinfoUrl = 'http://119.45.233.102:2244/testgoup/user/getUserInfo'headers = {'token': token}r = requests.request(method='get', url=userinfoUrl, headers=headers)print(r.text)
上述实战代码均在 TestGoUp 网站开展测试,并对账号进行了加密,可自行注册获取自己的账号进行测试。
对响应结果的处理(序列化和反序列化)
上面代码中的 token = r.json()['data']['token']
里有一个细节这里要展开叙述一下。来看一下登录接口返回的响应结果,也就是 print(r.text)
的值:
{ "code": 1, "data": { "nickName": "liuyanzu666", "token": "eyJhbGci..."# token太长了,这里删掉部分数据 }, "message": "登录成功!"}
咋一看这是一个python字典类型的数据,有的同学可能说这是 json 类型的数据。到底是字典还是json类型的数据,我们使用 type()
方法对 r.text
进行判断即可。
print(type(r.text))# 返回结果是
返回结果居然是 str 类型的数据。现在我们要从 r.text
中获取 token
值,如果我们将它从 str 类型转换成字典类型,那么就可以通过 token
键获取对应的 toekn
值了。这里就引出了我们要讲的知识点:
Python序列化和反序列化
序列化:将Python中字典类型的数据转换成json格式的字符串,以便进行存储和传输。
反序列化:将json格式的字符串转换成Python的字典类型数据,便于对其分析和处理。
我们可以使用 json 模块来实现序列化和反序列化:
import json# 字典类型的数据data = { "name": "张三", "age": 18}# 使用 json.dumps() 进行序列化:字典-->字符串res = json.dumps(data)print(res) # 输出结果:{"name": "\u5f20\u4e09", "age": 18}print(type(res)) # 输出结果:# 使用 json.loads() 进行反序列化:字符串-->字典res2 = json.loads(res)print(res2) # 输出结果:{'name': '张三', 'age': 18}print(type(res2)) # 输出结果:
上面阐述了使用 python 进行序列化和反序列化的方法,但是在登录接口中获取token值的时候 ,我们并没有使用 json.loads()
进行反序列化,而是使用 “token = r.json()[‘data’][‘token’],也就是
r.json()` 方法。
也就是说在上面的代码中,获取token我们可以使用两种方法:
...r = requests.request(method=method, url=loginUrl, json=data)方法一:token = json.loads(r.text)['data']['token']方法二:token = r.json()['data']['token']...
至此,关于 Python Requests 的介绍就告一段落了,感谢您的阅读。如果本文对您有帮助,请帮我点个赞吧~如果想获取本文的 markdown 笔记、电子书和相关源代码,请关注我的WX公众号[愿泽君],发送 “python requests” 即可。