PYTHON帮助

Python 中的请求库：教程

查克尼特·宾

2024年七月1日

在网络开发和数据获取的多样化环境中，Python 是一门特殊的语言。 HTTP 是一种基于 HTTP 的应用程序，它的简单性加上功能强大的库，使其成为处理 HTTP 请求的理想选择。在这些库中，Python的Requests模块以其多功能和用户友好的特性在与网络服务交互中脱颖而出。

在本文中，我们将探讨HTTP请求的基本原理，并研究Requests库如何帮助Python开发人员高效地处理这些请求。我们还将研究 HTTP 请求如何与 IronPDF for Python 这样的库配合使用，从而轻松制作和编辑 PDF。

了解 HTTP 请求

HTTP（超文本传输协议）是万维网上数据通信的基础。它是一个协议，用于管理客户（网页浏览器）和服务器之间超文本（例如HTML）的传输。 HTTP 是一种请求-响应协议，客户端向服务器发送请求，服务器则响应所请求的资源。

HTTP 请求通常由几个部分组成：

HTTP 方法：指定客户端希望执行的操作以发出 HTTP 请求。常见的方法包括 GET、POST、PUT、DELETE 等。
URL：统一资源定位器，用于标识所请求的资源。
请求头：随请求发送的附加信息，例如身份验证凭据、内容类型等。
正文：通过POST或PUT请求发送的数据。

请求库介绍

Python 中的Requests库简化了发出 HTTP 请求的过程。它提供了一个优雅直观的 API，用于发送各种类型的请求并无缝处理响应。

Requests Python（开发人员如何使用）：图1 - 包含安装的 Requests 库网页

让我们浏览一些基本的使用示例，但首先，让我们看看安装Requests模块的过程。

安装

在使用Requests库之前，请确保它已安装。您可以通过 pip 安装：

pip install requests

提出 GET 请求

使用 requests.get() 方法向此处指定的 URL 发出 GET 请求：

import requests
response = requests.get('https://api.example.com/data')
print(response.text)

import requests
response = requests.get('https://api.example.com/data')
print(response.text)

PYTHON

此代码向指定的 URL https://api.example.com/data 发送 GET 请求并打印响应主体。

提出 POST 请求

要发送带有数据的POST请求，请使用requests.post()方法：

import requests
data = {'key': 'value'}
response = requests.post('https://api.example.com/post', data=data)
print(response.json())

import requests
data = {'key': 'value'}
response = requests.post('https://api.example.com/post', data=data)
print(response.json())

PYTHON

这里，我们向https://api.example.com/post发送包含JSON数据的POST请求，并打印JSON响应数据。

处理响应对象

HTTP 请求返回的响应对象提供了各种属性和方法来访问响应的不同方面，如 HTTP 标头、状态代码、内容等。例如

import requests
response = requests.get('https://api.example.com/data')
print(response.status_code)  # Print the status code
print(response.headers)      # Print response headers

import requests
response = requests.get('https://api.example.com/data')
print(response.status_code)  # Print the status code
print(response.headers)      # Print response headers

PYTHON

错误处理

在进行 HTTP 请求时，优雅地处理错误至关重要。 Requests库通过为常见错误（如连接错误和超时）引发异常来简化错误处理。例如

import requests
try:
    response = requests.get('https://api.example.com/data')
    response.raise_for_status()  # Raise an exception for HTTP errors
except requests.exceptions.HTTPError as err:
    print(err)

import requests
try:
    response = requests.get('https://api.example.com/data')
    response.raise_for_status()  # Raise an exception for HTTP errors
except requests.exceptions.HTTPError as err:
    print(err)

PYTHON

禁用 SSL 证书验证

在requests库中，你可以通过在请求中将verify参数设置为False来禁用SSL证书验证：

import requests
# Disable SSL certificate verification
response = requests.get('https://api.example.com/data', verify=False)
# Process the response
print(response.text)

import requests
# Disable SSL certificate verification
response = requests.get('https://api.example.com/data', verify=False)
# Process the response
print(response.text)

PYTHON

包括查询字符串

您还可以通过使用params参数附加查询参数到您的URL中：

import requests
# Define query parameters
params = {'key': 'value', 'param2': 'value2'}
# Make a GET request with query parameters
response = requests.get('https://api.example.com/data', params=params)
# Process the response
print(response.text)

import requests
# Define query parameters
params = {'key': 'value', 'param2': 'value2'}
# Make a GET request with query parameters
response = requests.get('https://api.example.com/data', params=params)
# Process the response
print(response.text)

PYTHON

在此示例中，params 字典包含查询参数。进行GET请求时，这些参数会自动附加到URL中，结果请求URL类似于https://api.example.com/data?key=value&param2=value2。

将 Requests 与 IronPDF 集成以生成 PDFs

在深入实施之前，让我们先简单了解一下 IronPDF。

IronPDF - Python PDF 库

IronPDF for Python 是一个流行的 Python 库，用于生成、阅读、编辑和操作 PDF 文档。它提供了一套丰富的功能，可通过编程创建外观专业的 PDF。

Requests Python（开发人员如何使用）：图 2 - IronPDF 网页

要使用 IronPdf 利用通过 Requests 获取的内容生成 PDF，请按照以下步骤操作：

步骤 1：安装 IronPDF

首先，确保您的 Python 环境中已安装 IronPDF。您可以通过 pip 安装：

pip install ironpdf

第 2 步：通过请求获取内容

使用请求库获取您希望包含在 PDF 中的内容。例如

import requests
response = requests.get('https://api.example.com/data')
data = response.text

import requests
response = requests.get('https://api.example.com/data')
data = response.text

PYTHON

第 3 步：使用 IronPDF 生成 PDF

获得内容后，使用 IronPDF 生成 PDF。这是一个基本的例子：

from ironpdf import *
# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from the data received from requests
pdf = renderer.RenderHtmlAsPdf(data)
# Export to a file
pdf.SaveAs("output.pdf")

from ironpdf import *
# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from the data received from requests
pdf = renderer.RenderHtmlAsPdf(data)
# Export to a file
pdf.SaveAs("output.pdf")

PYTHON

在此示例中，data 包含通过 Requests 获取的 HTML 内容。 IronPDF 的 RenderHtmlAsPdf() 方法将该 HTML 内容转换为 PDF 文档。最后，PDF 使用 SaveAs() 方法保存到文件。

通过Requests库，Python使与网络的交互变得轻而易举，使开发人员能够更加专注于构建出色的应用程序，而不必处理HTTP通信的复杂性。

高级用法

您可以使用 IronPDF 的广泛功能，通过自定义 PDF 设置、页边距、方向、图像、CSS、JavaScript 等，进一步增强 PDF 生成过程。例如

renderer.RenderingOptions.MarginTop = 40  # millimeters
renderer.RenderingOptions.MarginLeft = 20  # millimeters
renderer.RenderingOptions.MarginRight = 20  # millimeters
renderer.RenderingOptions.MarginBottom = 40  # millimeters

# Example with HTML Assets
# Load external html assets: Images, CSS, and JavaScript.
# An optional BasePath 'C:\\site\\assets\\' is set as the file location to load assets from
my_advanced_pdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", "C:\\site\\assets")
my_advanced_pdf.SaveAs("html-with-assets.pdf")

renderer.RenderingOptions.MarginTop = 40  # millimeters
renderer.RenderingOptions.MarginLeft = 20  # millimeters
renderer.RenderingOptions.MarginRight = 20  # millimeters
renderer.RenderingOptions.MarginBottom = 40  # millimeters

# Example with HTML Assets
# Load external html assets: Images, CSS, and JavaScript.
# An optional BasePath 'C:\\site\\assets\\' is set as the file location to load assets from
my_advanced_pdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", "C:\\site\\assets")
my_advanced_pdf.SaveAs("html-with-assets.pdf")

PYTHON

在这里，我们要设置页边距，并从基本目录中添加图片，然后将其保存为文件。

有关 IronPDF 功能和性能的更多信息，请访问文档页面，并查看这些与 Python 集成的即用代码示例。

结论

Python 中的Requests库为发出 HTTP 请求提供了一个强大且简单的接口。无论您是要从 API 获取数据、与网络服务交互还是刮擦网页，Requests 都能利用其直观的 API 和强大的功能简化 HTTP 请求流程。

将 IronPDF for Python 与 Requests in Python 结合使用，为从获取的内容动态生成 PDF 文档开辟了广阔的天地。通过遵循本文概述的步骤并探索 IronPDF 和 Requests 的高级功能，Python 开发人员可以简化 PDF 生成工作流程，并根据自己的特定需求量身定制高质量文档。

Requests Python（开发人员如何使用）：图3 - IronPDF 许可页面