قم بتحويل HTML إلى PDF باستخدام SDK الخاص بـ Node.js.
تحويل HTML الملفات أو صفحات الويب إلى PDF أمر ضروري لإنشاء مستندات قابلة للطباعة، والحفاظ على التخطيطات، وأرشفة المحتوى بتنسيق محمول. باستخدام GroupDocs.Conversion Cloud SDK لـ Node.js، يمكنك أتمتة هذه العملية عبر REST API دون الحاجة إلى أي أدوات من طرف ثالث أو اعتمادات متصفح.
في هذه المقالة، ستتعلم كيفية:
- 🌐 واجهة برمجة التطبيقات لتحويل HTML إلى PDF لـ Node.js
- 🚀 تحويل HTML إلى PDF باستخدام Node.js
- 💻 تحويل HTML إلى PDF باستخدام cURL
🌐 واجهة برمجة تطبيقات تحويل HTML إلى PDF لـ Node.js
يفعل GroupDocs.Conversion Cloud SDK for Node.js تحويلًا عالي الجودة وقابلية التوسع من تنسيق HTML إلى PDF مع الحفاظ على التصميم والتخطيط والوسائط المدمجة.
📦 تثبيت SDK
قم بالتثبيت باستخدام npm:
npm install groupdocs-conversion-cloud --save
Ensure that you have your personalized Client ID and Client Secret from the GroupDocs Cloud Dashboard. For further details, you may consider visiting this tutorial.
🚀 تحويل HTML إلى PDF باستخدام Node.js
إليك دليل خطوة بخطوة لتحويل مستند PDF إلى HTML باستخدام Node.js:
📌 Step 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](https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet)
// احصل على بيانات اعتماد واجهة برمجة التطبيقات الخاصة بك
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// إنشاء مثيل لفئة Configuration وتهيئته بمعرف العميل و秘密 العميل
Configuration configuration = new Configuration(clientId, clientSecret);
// حدد عنوان 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());
}
صورة:- معاينة لتحويل HTML إلى PDF.
قم بتنزيل ملف PDF النموذجي الذي تم إنشاؤه في المثال أعلاه من resultant.pdf.
💻 تحويل HTML إلى PDF باستخدام cURL
هل تفضل واجهة سطر الأوامر؟ يمكنك أيضًا تحويل HTML إلى PDF باستخدام cURL مع GroupDocs.Conversion Cloud نقطة النهاية API.
- ✅ هذه الطريقة مثالية لخطوط أنابيب الأتمتة والتحويلات المعتمدة على السكрипتات.
الخطوة 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 لـ Node.js، يمكنك تحويل HTML إلى PDF بسرعة وموثوقية—وهو مثالي للمطورين الذين يبنون ميزات أتمتة الوثائق أو يقومون بتصدير محتوى HTML المنسق كـ PDF.
سواء كنت تقوم بإدماج ذلك في خادم Node.js أو تستخدمه عبر cURL، فإن هذه الواجهة البرمجية تقدم مرونة وتحكم.
🔗 موارد مفيدة
📚 المقالات الموصى بها
نوصي باستكشاف المقالات التالية: