from ironpdf import * # Instantiate Renderer renderer = ChromePdfRenderer() # Create a PDF from a HTML string using Python pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>") # Export to a file or Stream pdf.SaveAs("output.pdf") # Advanced 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 myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", r"C:\site\assets") myAdvancedPdf.SaveAs("html-with-assets.pdf")

PYTHON帮助

Python 中的 Requests 库：教程

Curtis Chau

已更新:2026年1月18日

在多样化的网页开发和数据获取环境中，Python是一种出色的语言。它的简洁性，加上强大的库，使其成为处理HTTP请求的理想选择。在这些库中，Python Requests 模块脱颖而出，成为与 Web 服务交互的多功能且用户友好的工具。

在本文中，我们将探讨 HTTP 请求的基础知识，并探索 Requests 库如何帮助 Python 开发人员高效地处理它们。我们还将研究如何将HTTP请求与像IronPDF for Python这样的库一起使用，轻松制作和编辑PDF文件。

了解HTTP请求

HTTP（超文本传输协议）是万维网数据通信的基础。它是一种协议，用于管理客户端（网页浏览器）和服务器之间超文本（如HTML）的传输。 HTTP作为一种请求-响应协议运行，其中客户端向服务器发送请求，然后服务器以请求的资源作出响应。

通常，HTTP请求由几个组件组成：

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

介绍Requests库

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

Requests Python（开发者使用方法）：图 1 - Requests 库网页，包含安装说明

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

安装

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

pip install requests

pip install requests

SHELL

进行GET请求

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

import requests

# Make a GET request to the URL
response = requests.get('https://api.example.com/data')

# Print the response text (content of the response)
print(response.text)

import requests

# Make a GET request to the URL
response = requests.get('https://api.example.com/data')

# Print the response text (content of the response)
print(response.text)

PYTHON

这段代码向指定的 URL https://api.example.com/data 发送 GET 请求，并打印响应正文。

进行POST请求

要发出包含数据的 POST 请求，请使用 requests.post() 方法：

import requests

# Data to send in the POST request
data = {'key': 'value'}

# Make a POST request with data
response = requests.post('https://api.example.com/post', data=data)

# Print the response in JSON format
print(response.json())

import requests

# Data to send in the POST request
data = {'key': 'value'}

# Make a POST request with data
response = requests.post('https://api.example.com/post', data=data)

# Print the response in JSON format
print(response.json())

PYTHON

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

处理响应对象

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

import requests

# Make a GET request
response = requests.get('https://api.example.com/data')

# Print the status code of the response
print(response.status_code)

# Print the response headers
print(response.headers)

import requests

# Make a GET request
response = requests.get('https://api.example.com/data')

# Print the status code of the response
print(response.status_code)

# Print the response headers
print(response.headers)

PYTHON

错误处理

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

import requests

try:
    # Make a GET request
    response = requests.get('https://api.example.com/data')

    # Raise an exception for HTTP errors
    response.raise_for_status()
except requests.exceptions.HTTPError as err:
    # Print the error message
    print(err)

import requests

try:
    # Make a GET request
    response = requests.get('https://api.example.com/data')

    # Raise an exception for HTTP errors
    response.raise_for_status()
except requests.exceptions.HTTPError as err:
    # Print the error message
    print(err)

PYTHON

禁用SSL证书验证

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

import requests

# Make a GET request with SSL verification disabled
response = requests.get('https://api.example.com/data', verify=False)

# Process the response
print(response.text)

import requests

# Make a GET request with SSL verification disabled
response = requests.get('https://api.example.com/data', verify=False)

# Process the response
print(response.text)

PYTHON

包含查询字符串

您还可以通过在 URL 后附加 params 参数来包含查询参数：

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 中，从而产生类似 https://api.example.com/data?key=value&param2=value2 的请求 URL。

将Requests与IronPDF集成以生成PDF

在深入实现之前，让我们简要了解IronPDF。

IronPDF - Python PDF库

IronPDF for Python是一种流行的Python库，用于生成、读取、编辑和操作PDF文档。它提供了一套丰富的功能，以程序化地创建专业外观的PDF。

Python请求（开发者使用方法）：图2 - IronPDF网页

要使用IronPDF生成通过Requests获取的内容的PDF，请按以下步骤进行：

步骤1：安装IronPDF

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

pip install ironpdf

pip install ironpdf

SHELL

步骤2：使用Requests获取内容

使用Requests库获取你希望包含在PDF中的内容。例如：

import requests

# Make a GET request to fetch data
response = requests.get('https://api.example.com/data')
data = response.text

import requests

# Make a GET request to fetch data
response = requests.get('https://api.example.com/data')
data = response.text

PYTHON

步骤 3：使用 IronPDF 生成 PDF

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

from ironpdf import ChromePdfRenderer

# 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 ChromePdfRenderer

# 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 文档。最后，使用 SaveAs() 方法将 PDF 保存到文件中。

借助 Requests 库，Python 可以轻松与 Web 进行交互，使开发人员能够更专注于构建优秀的应用程序，而不是处理 HTTP 通信的复杂性。

高级用法

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

# Set page margins
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")

# Set page margins
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集成。