عمل تبدیل HTML به PDF با استفاده از SDK Node.js.
تبدیل HTML فایل‌ها یا صفحات وب به PDF برای ایجاد اسناد قابل چاپ، حفظ طرح‌بندی‌ها و آرشیو کردن محتوا در یک فرمت قابل حمل ضروری است. با استفاده از GroupDocs.Conversion Cloud SDK برای Node.js، می‌توانید این فرآیند را از طریق REST API به صورت خودکار انجام دهید بدون نیاز به هیچ ابزار یا وابستگی مرورگری شخص ثالث.
در این مقاله، شما خواهید آموخت چگونه:
- 🌐 API تبدیل HTML به PDF برای Node.js
- 🚀 تبدیل HTML به PDF با استفاده از Node.js
- 💻 تبدیل HTML به PDF با cURL
🌐 API تبدیل HTML به PDF برای Node.js
GroupDocs.Conversion Cloud SDK for Node.js امکان تبدیل با کیفیت بالا و مقیاس‌پذیر از فرمت HTML به PDF را با حفظ طراحی، چیدمان و رسانه‌های جاسازی‌شده فراهم می‌کند.
📦 نصب SDK
با استفاده از npm نصب کنید:
npm install groupdocs-conversion-cloud --save
اطمینان حاصل کنید که شناسه مشتری شخصی و رمزنگاری مشتری خود را از GroupDocs Cloud Dashboard دارید. برای اطلاعات بیشتر، می‌توانید به این tutorial مراجعه کنید.
🚀 تبدیل HTML به PDF با استفاده از Node.js
در اینجا یک راهنمای مرحله به مرحله برای تبدیل یک سند PDF به HTML با استفاده از Node.js آورده شده است:
📌 مرحله ۱: وارد کردن 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);
📌 مرحله ۳: تنظیم گزینه‌های تبدیل 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.");
// بیشتر مثال‌ها در 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);
// تعریف URL پایه API برای انجام تبدیل PDF به HTML به صورت آنلاین
configuration.setApiBaseUrl("https://api.groupdocs.cloud");
// یک نمونه از ConvertApi را با شیء پیکربندی راه‌اندازی کنید.
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());
}
تصویر:- پیش نمایش تبدیل HTML به PDF.
فایل PDF نمونه‌ای که در مثال بالا生成 شده است را از resultant.pdf دانلود کنید.
💻 HTML را با cURL به PDF تبدیل کنید
آیا شما CLI را ترجیح می‌دهید؟ شما همچنین می‌توانید HTML را با استفاده از cURL به PDF تبدیل کنید با GroupDocs.Conversion Cloud API endpoint.
- ✅ این روش برای پایپ‌لاین‌های خودکار و تبدیل‌های مبتنی بر اسکریپت ایده‌آل است.
مرحله ۱: دریافت توکن دسترسی 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 برای Node.js، می‌توانید به سرعت و به‌طور قابل اعتماد HTML را به PDF تبدیل کنید—ایده‌آل برای توسعه‌دهندگانی که در حال ساخت ویژگی‌های اتوماسیون مستندات یا صادرات محتوای HTML با استایل به عنوان PDF هستند.
چه شما این را در یک بک‌اند Node.js تعبیه کنید یا از طریق cURL استفاده کنید، این API انعطاف‌پذیری و کنترل را ارائه می‌دهد.
🔗 منابع مفید
📚 مقالات پیشنهادی
ما به بررسی مقالات زیر پیشنهاد می‌کنیم: