使用 Node.js SDK 執行 HTML 到 PDF 的轉換。
將 HTML 檔案或網頁轉換為 PDF 是生成可列印文件、保留佈局和以可攜式格式歸檔內容的必要步驟。使用 GroupDocs.Conversion Cloud SDK for Node.js，您可以通過 REST API 自動化此過程，而無需任何第三方工具或瀏覽器依賴。
在這篇文章中，您將學習如何：
🌐 HTML to PDF 轉換 API for Node.js
GroupDocs.Conversion Cloud SDK for Node.js 使得從 HTML 到 PDF 格式的高品質、可擴展轉換成為可能，同時維持設計、佈局和嵌入媒體。
📦 安裝 SDK
使用 npm 安裝：
npm install groupdocs-conversion-cloud --save
確保您擁有來自 GroupDocs Cloud Dashboard 的個人化客戶 ID 和客戶密鑰。如需更多詳細資訊，您可以考慮訪問這個 tutorial。
🚀 使用 Node.js 將 HTML 轉換為 PDF
這裡有一個使用 Node.js 將 PDF 文件轉換為 HTML 的逐步指南：
📌 步驟 1：導入 SDK 並配置 API：
const { Configuration, ConvertApi, FileApi, UploadFileRequest, ConvertSettings, ConvertDocumentRequest } = require("groupdocs-conversion-cloud");
const config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
const convertApi = new ConvertApi(config);
const fileApi = new FileApi(config);
📌 第 2 步：將輸入的 HTML 文件上傳至雲端儲存：
const fs = require("fs");
const uploadRequest = new UploadFileRequest("input.html", fs.createReadStream("input.html"));
await fileApi.uploadFile(uploadRequest);
📌 第 3 步：設置 HTML 到 PDF 轉換選項：
const settings = new ConvertSettings();
settings.filePath = "input.html";
settings.format = "pdf";
settings.outputPath = "converted/output.pdf";
const request = new ConvertDocumentRequest(settings);
await convertApi.convertDocument(request);
console.log("✅ The HTML successfully converted to PDF.");
// More examples over https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// 獲取您的 API 憑證
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// 創建 Configuration 類的實例，並用 Client ID 和 Client Secret 進行初始化。
Configuration configuration = new Configuration(clientId, clientSecret);
// 定義 API 基本 URL 以進行在線 PDF 到 HTML 轉換
configuration.setApiBaseUrl("https://api.groupdocs.cloud");
// 初始化一個 ConvertApi 的實例，使用 Configuration 物件
ConvertApi convertApi = new ConvertApi(configuration);
ConvertSettings settings = new ConvertSettings();
settings.setStorageName("internal");
settings.setFilePath("input.html");
settings.setFormat("PDF");
settings.setOutputPath("resultant.pdf");
// 使用 ConvertDocument 方法將 HTML 轉換為 PDF 格式
ConvertDocumentRequest request = new ConvertDocumentRequest(settings);
List<StoredConvertedResult> response = convertApi.convertDocument(request);
// 檢查回應並打印成功消息
if (response != null && response.equals("OK")) {
System.out.println("The HTML file is successfully converted PDF! The Resultant PDF file is saved at: " + response.getFilePath());
}
Image:- A preview of HTML to PDF conversion.
下載從 resultant.pdf 生成的示例 PDF 文件。
💻 使用 cURL 將 HTML 轉換為 PDF
你喜歡 CLI 嗎？你也可以使用 cURL 透過 GroupDocs.Conversion Cloud API 端點將 HTML 轉換為 PDF。
- ✅ 此方法非常適合自動化管道和基於腳本的轉換。
步驟 1：獲取 JWT 存取權杖
curl -v "https://api.groupdocs.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"
步驟 2：將 HTML 轉換為 PDF
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourcePDF}\", \"Format\": \"html\", \"OutputPath\": \"{finalOutput}\"}"
將 sourceFile、resultantFile 和 accessToken 替換為實際值。
- 現在為了將 PDF 儲存到本地磁碟，您可以考慮使用以下 cURL 命令：
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"html\"}" \
-o "myOutput.html"
🧪 嘗試免費的 HTML 到 PDF 轉換器 在線
想要一個快速的無需編碼的解決方案嗎？使用 HTML to PDF Converter 立即轉換網頁內容。
✅ 結論
使用 GroupDocs.Conversion Cloud SDK for Node.js，您可以快速且可靠地將 HTML 轉換為 PDF——非常適合開發人員構建文件自動化功能或將樣式化的 HTML 內容導出為 PDF。
無論您是在 Node.js 後端嵌入這個還是通過 cURL 使用它，這個 API 都提供了靈活性和控制力。
🔗 有用的資源
📚 推薦文章
我們建議探索以下文章：