当前位置：首页 > news >正文

Python Requests模块全面教程

news 2025/7/6 11:12:06

Python Requests模块全面教程

在现代软件开发中，网络请求是一个不可或缺的部分。无论是获取网页数据、调用API接口，还是进行数据交互，都会涉及到HTTP请求。Python的Requests模块是一个非常强大的库，能够让我们轻松地发送HTTP请求并处理响应。本文将详细介绍Requests模块的使用，包括基本用法、参数设置、常见请求类型、异常处理、文件上传、会话管理等高级用法，并附带实例和图示，帮助你全面掌握这一工具。
在这里插入图片描述

一、环境准备

在开始之前，请确保你已经安装了Python和Requests库。如果还没有安装，可以使用以下命令进行安装：

pip install requests

二、Requests模块基础

1. 发送GET请求

GET请求是最常见的HTTP请求类型之一。使用Requests模块发送GET请求非常简单，以下是一个基本示例：

import requestsresponse = requests.get('https://api.github.com')
print(response.status_code)  # 打印响应状态码
print(response.json())       # 打印响应内容（JSON格式）

代码解析

requests.get(url)：发送GET请求，返回一个响应对象。
response.status_code：获取响应状态码，200表示请求成功。
response.json()：将响应内容解析为JSON格式（前提是响应内容是JSON格式）。

2. 发送POST请求

POST请求通常用于提交数据。以下是一个发送POST请求的示例：

url = 'https://httpbin.org/post'
data = {'name': 'Alice', 'age': 25}response = requests.post(url, data=data)
print(response.json())

代码解析

requests.post(url, data=data)：发送POST请求，将数据以表单形式提交。

三、请求参数设置

Requests模块支持多种参数设置，包括URL参数、请求头、Cookies等。

1. URL参数

在GET请求中，我们可以通过params参数传递URL参数：

params = {'q': 'requests+language:python'}
response = requests.get('https://api.github.com/search/repositories', params=params)
print(response.json())

2. 请求头

我们可以通过headers参数设置请求头：

headers = {'User-Agent': 'Mozilla/5.0','Accept': 'application/json'
}response = requests.get('https://api.github.com', headers=headers)
print(response.json())

3. Cookies

Requests模块也支持Cookies的设置和发送：

cookies = {'session_id': '123456789'}
response = requests.get('https://httpbin.org/cookies', cookies=cookies)
print(response.json())

四、异常处理

在发送请求时，可能会遇到各种异常情况。Requests模块提供了简单的异常处理机制。

1. 捕获异常

我们可以使用try...except语句捕获异常：

try:response = requests.get('https://api.github.com/invalid-url')response.raise_for_status()  # 检查请求是否成功
except requests.exceptions.HTTPError as err:print(f'HTTP error occurred: {err}')
except Exception as err:print(f'Other error occurred: {err}')

五、文件上传

Requests模块支持文件上传功能，以下是一个示例：

url = 'https://httpbin.org/post'
files = {'file': open('example.txt', 'rb')}
response = requests.post(url, files=files)
print(response.json())

六、会话管理

Requests模块提供了会话管理功能，可以在多个请求之间保持某些参数（如Cookies）。

1. 创建会话

session = requests.Session()
session.headers.update({'User-Agent': 'Mozilla/5.0'})response = session.get('https://httpbin.org/headers')
print(response.json())

2. 使用会话发送请求

response = session.get('https://httpbin.org/cookies/set?name=value')
print(response.json())response = session.get('https://httpbin.org/cookies')
print(response.json())

七、拓展内容

1. 处理JSON数据

Requests模块可以直接处理JSON数据，以下是一个示例：

response = requests.get('https://api.github.com')
data = response.json()# 处理JSON数据
for repo in data['repositories']:print(repo['name'])

2. 自定义超时设置

在发送请求时，我们可以设置超时时间，避免请求过长时间未响应：

try:response = requests.get('https://api.github.com', timeout=5)
except requests.exceptions.Timeout:print('The request timed out')

3. 代理设置

Requests模块支持HTTP代理设置：

proxies = {'http': 'http://10.10.1.10:3128','https': 'http://10.10.1.10:1080',
}response = requests.get('https://api.github.com', proxies=proxies)
print(response.json())