PYTHON 幫助

Python中的Requests庫：教程

發佈 2024年7月1日

在多樣化的網頁開發和數據獲取環境中，Python 是一種出色的語言。它的簡潔性，加上強大的庫，使其成為處理 HTTP 請求的理想選擇。在這些程式庫中，Python 的 Requests 模組以其多功能且使用者友好的特性，在與網路服務互動時表現突出。

在本文中，我們將了解 HTTP 請求的基礎知識，並探討 Requests 庫如何幫助 Python 開發人員有效地處理這些請求。我們還將研究如何使用像 IronPDF for Python 這樣的庫來進行 HTTP 請求，使得生成和編輯 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

在此，我們使用 JSON 數據向 https://api.example.com/post 發送 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，從而生成類似於 https://api.example.com/data?key=value&param2=value2 的請求 URL。

將請求與IronPDF整合以生成PDF文件

在深入實施之前，我們來簡要了解一下IronPDF。

IronPDF - Python PDF 庫

IronPDF for Python 是一個熱門的 Python 庫，用於生成、閱讀、編輯和操作 PDF 文件。它提供了一套豐富的功能，用於以程式化方式創建具有專業外觀的 PDF。

Requests Python（適用於開發人員）：圖2 - IronPDF網頁

要使用IronPDF生成PDF並透過Requests獲取內容，請遵循以下步驟：

步驟 1：安裝 IronPDF

首先，確保在您的 Python 環境中安裝了 IronPDF。您可以透過 pip 安裝：

pip install ironpdf

步驟 2：使用 Requests 獲取內容

使用 Requests 庫來獲取您想要包含在 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 文件。最後，使用SaveAs方法將 PDF 儲存至檔案。() 方法。

使用 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 與 Python 中的 Requests 結合使用，為從抓取的內容動態生成 PDF 文件開闢了無限的可能性。透過遵循本文所列步驟並探索 IronPDF 和 Requests 的高級功能，Python 開發人員可以簡化其 PDF 生成工作流程，並生成符合其特定需求的高質量文件。

Requests Python（對開發者的運作方式）：圖 3 - IronPDF 授權頁面