html to pdf online

محول HTML إلى PDF عبر الإنترنت باستخدام C# .NET.

تحويل HTML المحتوى إلى PDF أمر ضروري للمشاركة والطباعة والأرشفة أو الحفاظ على التنسيق. مع GroupDocs.Conversion Cloud SDK لـ .NET، يمكنك إجراء تحويلات HTML إلى PDF عالية الدقة دون الاعتماد على إضافات المتصفح أو الأدوات الخارجية.

في هذا المقال، ستتعلم كيفية:

API تحويل HTML إلى PDF

ما هو GroupDocs.Conversion Cloud SDK for .NET هو واجهة برمجة تطبيقات REST عالية الجودة وقابلة للتوسع تقدم إمكانيات لتحويل HTML إلى PDF عبر الإنترنت. إنه يضمن أن يتم الحفاظ على تنسيق المحتوى بما في ذلك التصميم والتخطيط والوسائط المضمنة في ملف PDF الناتج.

المتطلبات الأساسية

قم بتثبيت SDK باستخدام NuGet:

تثبيت باستخدام npm:

PM> NuGet\Install-Package GroupDocs.Conversion-Cloud

خطوة بخطوة: تحويل HTML إلى PDF في C#

يرجى اتباع الخطوات الموضحة أدناه لأداء تحويل HTML إلى PDF مجاني عبر الإنترنت باستخدام C# .NET:

📌 الخطوة 1: تهيئة إعدادات API:

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};

var convertApi = new ConvertApi(config);
var fileApi = new FileApi(config);

📌 الخطوة 2: تحميل ملف HTML إلى تخزين السحابة:

using (var fileStream = File.OpenRead("input.html"))
{
    var uploadRequest = new UploadFileRequest("input.html", fileStream);
    fileApi.UploadFile(uploadRequest);
}

📌 Step 3: تعريف إعدادات التحويل وتحويل:

var settings = new ConvertSettings
{
    FilePath = "input.html",
    Format = "pdf",
    OutputPath = "converted/output.pdf"
};

var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);
Console.WriteLine("✅ HTML file successfully converted to PDF.");

// More examples over https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// احصل على بيانات اعتماد واجهة برمجة التطبيقات الخاصة بك 
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";

// إنشاء نسخة من فئة Configuration وتعيينها بمعرّف العميل وسر العميل. 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// حدد قيمة ApiBaseUrl لتعيين عنوان url الأساسي لواجهة برمجة تطبيقات تحويل html إلى PDF.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// قم بتهيئة مثيل لفئة ConvertApi باستخدام كائن من فئة Configuration.
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
             
// تحميل ملف HTML من محرك الأقراص المحلي             
using (var stream = System.IO.File.OpenRead("converted.html"))
{
    // أنشئ مثيلًا من FileApi
    var fileUpload = new FileApi(configurations);
    // رفع ملف HTML المدخل إلى تخزين سحابي
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // إنشاء ConvertSettings حيث نقوم بتعريف HTML المدخل واسم ملف PDF الناتج.
    var settings = new ConvertSettings
    {
        StorageName = "internal",
        FilePath = "input.html",
        Format = "pdf",
        OutputPath = "resultant.pdf"
    };
    
    // استدعِ طريقة ConvertDocument لتحويل HTML إلى PDF برمجيًا.
    var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // print succeess message
        Console.WriteLine("HTMl to PDF conversion completed successfully !");
    }
}
محول مجاني من HTML إلى PDF

صورة:- معاينة لتحويل HTML إلى PDF.

قم بتنزيل ملف PDF النموذج المتولد في المثال أعلاه من resultant.pdf.

اختياري: تحويل HTML إلى PDF باستخدام cURL

إذا كنت تفضل استخدام أدوات سطر الأوامر أو خطوط أنابيب الأتمتة، يمكن أن يكون GroupDocs.Conversion Cloud أيضًا يمكن الوصول إليه عبر cURL.

  • هذه الطريقة مثالية لخطوط أنابيب الأتمتة والتحويلات المعتمدة على السكربتات.

الخطوة 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}\"}"

Replace:

  • sourceFile, resultantFile, and accessToken with actual values.
  • الآن، من أجل حفظ ملف 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 لتحويل محتوى الويب على الفور.

محول PDF إلى PPT مجاني على الإنترنت

استنتاج

مع مساعدة GroupDocs.Conversion Cloud SDK لـ .NET، يمكنك تحويل HTML إلى PDF بسلاسة داخل تطبيقات C#. سواء كان ذلك لتصدير المستندات، أو إنشاء التقارير، أو أرشفة محتوى الويب المنسق، تقدم هذه واجهة برمجة التطبيقات (API) مرونة كاملة وتحكمًا.

الموارد المفيدة

مقالات ذات صلة

نوصي باستكشاف المقالات التالية: