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 LR
id1(填写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 requests

method = "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) # 查看请求url
print(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) # 获取 cookies
print(res.headers) # 查看响应的响应头
print(res.url) # 查看响应的url

如果响应内容中文显示是乱码,在此提供2种解决方案:

import requests

url = "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 requests

url = "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 伪装策略的更多知识请参考以下博文:

发起 POST 请求

1)传递 data 参数

当我们要向网页上的一些表单(form)传递数据时,经常需要发起 post 请求。使用 requests 发起 post 请求的方法也非常简单,只需要传递一个字典给 data 参数。

import requests

url = '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 requests

url = '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, json

url = '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, json

url = "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 json

a = {'a': '1',
'b': '2',
'c': '3'
}
print(type(a)) # 输出 <class 'dict'> b = json.loads('{"age": "12"}') # 参数是str行,loads之后,变成dict字典了
print(b) # 输出 {'age': '12'}
print(type(b)) # 输出 <class 'dict'>

(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 requests
from requests_toolbelt.multipart.encoder import MultipartEncoder method = "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 requests
url = "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 requests

method = "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/get
import requests url = 'http://httpbin.org/get'
headers = {'User-Agent':'Mozilla/5.0'}
# 定义代理,在代理IP网站中查找免费代理IP
proxies = {
'http':'http://182.116.239.37:9999',
'https':'https://182.116.239.37:9999'
}
html = requests.get(url,proxies=proxies,headers=headers,timeout=5).text
print(html)

这里推荐几个免费代理网站,可自行尝试:

本部分参考来源:关于代理参数-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 requests

loginUrl = '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 requests

loginUrl = '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))		# 返回结果是 <class 'str'>

返回结果居然是 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)) # 输出结果:<class 'str'> # 使用 json.loads() 进行反序列化:字符串-->字典
res2 = json.loads(res)
print(res2) # 输出结果:{'name': '张三', 'age': 18}
print(type(res2)) # 输出结果:<class 'dict'>

上面阐述了使用 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" 即可。

python requests 最牛攻略的更多相关文章

  1. 史上最全的用Python操控手机APP攻略!建议收藏!

    ​最近经常看到用Python操作手机APP的项目,例如抖音.闲鱼之类的,看完后发现这些项目无一例外需要部署ADB环境.至于什么是ADB,很多大神都讲过,只是写得比较专业,我等菜鸟看完还是云里雾里. ​ ...

  2. python 抓取拉勾网 攻略

    废话不多说,直接上代码,将数据存入Mongdb import requests import pymongo import time import random mycon = pymongo.Mon ...

  3. 【Python challenge】通关代码及攻略(0-11)

    前言: 最近找到一个有关python的游戏闯关,这是游戏中的思考及通关攻略 最开始位于:http://www.pythonchallenge.com/pc/def/0.html 第0关 题目分析 提示 ...

  4. Python环境下NIPIR(ICTCLAS2014)中文分词系统使用攻略

    一.安装 官方链接:http://pynlpir.readthedocs.org/en/latest/installation.html 官方网页中介绍了几种安装方法,大家根据个人需要,自行参考!我采 ...

  5. 全栈数据工程师养成攻略:Python 基本语法

    全栈数据工程师养成攻略:Python 基本语法 Python简单易学,但又博大精深.许多人号称精通Python,却不会写Pythonic的代码,对很多常用包的使用也并不熟悉.学海无涯,我们先来了解一些 ...

  6. Python 自动化测试全攻略:五种自动化测试模型实战详解

    随着移动互联网的发展,软件研发模型逐步完善,软件交付质量越来越受到软件公司的重视,软件测试技术特别是自动化测试技术开始在软件系统研发过程中发挥着越来越重要的作用. 与传统的手工测试技术相比,自动化测试 ...

  7. python web工程师跳巢攻略

    python web工程师跳巢攻略 流程 一面问基础 二面问项目 三面问设计(经验) web请求的流程 浏览器 负载均衡 web框架 业务逻辑 数据库缓存 后端技术栈 python语言基础 语言特点 ...

  8. Win10系统下安装编辑器之神(The God of Editor)Vim并且构建Python生态开发环境(2020年最新攻略)

    原文转载自「刘悦的技术博客」https://v3u.cn/a_id_160 众神殿内,依次坐着Editplus.Atom.Sublime.Vscode.JetBrains家族.Comodo等等一众编辑 ...

  9. 极客时间-左耳听风-程序员攻略-Linux系统、内存和网络

    程序员练级攻略:Linux系统.内存和网络 Linux 系统相关 Red Hat Enterprise Linux 文档 . Linux Insides ,GitHub 上的一个开源电子书,其中讲述了 ...

  10. puppet完全攻略(一)puppet应用原理及安装部署

    puppet完全攻略(一)puppet应用原理及安装部署 2012-06-06 18:27:56 标签:puppet puppet应用原理 原创作品,允许转载,转载时请务必以超链接形式标明文章 原始出 ...

随机推荐

  1. 【云原生 · Docker】Docker虚拟化技术

    1.Docker入门简介 Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的Linux机器上,也可以实现虚拟化. 容器是完全使用沙箱 ...

  2. day29 jQuery选择器 & jquery属性操作 & jquery DOM元素 操作与遍历

    简介 jQuery,顾名思义,就是javascript和query(查询),即辅助javascript开发的库,本质就是一个js文件: jQuery是一个js函数库,是目前全球范围内最流行.用的最多的 ...

  3. docker入门(利用docker部署web应用)

    第一章 什么是docker1.1 docker的发展史2010年几个年轻人成立了一个做PAAS平台的公司dotCloud.起初公司发展的不错,不但拿到过一些融资,还获得了美国著名孵化器YCombina ...

  4. Windows下使用VSCode搭建IDA Python脚本开发环境

    由于本人是VSCode的重度沉迷用户,需要写代码时总会想起这个软件,因此选择在VSCode中搭建IDA Python的开发环境 本文适用的环境如下: 1.操作系统 windows 2.Python3 ...

  5. python @property的介绍与使用

    python @property的介绍与使用 python的@property是python的一种装饰器,是用来修饰方法的. 作用: 我们可以使用@property装饰器来创建只读属性,@proper ...

  6. Django测试脚本-单表操作(增删改查)-必知必会13条-神奇的双下划线

    目录 一:Django测试脚本 1.测试环境准备 2.tests.py 3.models.py 4.切换MySQL数据库 二:单表操作 1.pk关键字与get关键字 2.增 3.删 4.修 三:必知必 ...

  7. mysql数据库(字段约束条件)

    什么是字段约束 字段约束就是将字段的内容定一个规则,我们要按照规则办事 约束 描述 关键字 非空约束 限制该字段的数据不能为null not null 唯一约束 保证该字段的所有数据都是唯一.不重复的 ...

  8. [OpenCV实战]42 数码单反相机的技术细节

    在这篇文章中,我们将说明数码单反相机DSLR(Digital Single Lens Reflex Camera)的各个技术方面.本文将说明焦距(focal length),f-stop,景深(dep ...

  9. 区块链特辑——solidity语言基础(三)

    Solidity语法基础学习 五.映射类型: 映射型态 Mapping Type 映射钥匙Key → 真实资料 Value mapping(KeyType → ValueType) VariableN ...

  10. [Leetcode] 寻找数组的中心索引

    题目 代码 class Solution { public: int pivotIndex(vector<int>& nums) { int right=0; for(auto i ...