راهنمای جامع برای تبدیل HTML به PDF با NET REST API

در عصر دیجیتال امروزی، نیاز به تبدیل HTML به PDF اهمیت فزاینده ای پیدا کرده است. HTML، زبان وب، به ما امکان می دهد محتوای پویا و تعاملی ایجاد کنیم که در دستگاه ها و پلتفرم های مختلف قابل دسترسی باشد. با این حال، مواردی وجود دارد که برای محتوای وب خود به یک قالب ثابت تر و قابل دسترس تر نیاز داریم. PDF، با طرح‌بندی ثابت، سازگاری بین پلتفرم‌ها و ماهیت آماده چاپ، به عنوان یک راه‌حل ایده‌آل عمل می‌کند. در این مقاله، نکات و نکات تبدیل HTML به PDF را با استفاده از .NET REST API بررسی خواهیم کرد و به شما این امکان را می‌دهد که از قدرت PDF استفاده کنید و محتوای وب خود را به ارتفاعات جدیدی برسانید.

HTML به PDF تبدیل REST API
HTML به PDF در سی شارپ
با استفاده از دستورات cURL صفحه وب را به PDF تبدیل کنید

HTML به PDF تبدیل REST API

Aspose.HTML Cloud SDK for .NET ابزار قدرتمندی است که تبدیل یکپارچه HTML به PDF را امکان پذیر می کند. SDK یک رابط کاربر پسند و مجموعه ای غنی از روش ها و گزینه ها برای سفارشی کردن فرآیند تبدیل با توجه به نیازهای خاص ارائه می دهد. بنابراین، با Aspose.HTML Cloud SDK برای دات‌نت، توسعه‌دهندگان می‌توانند بدون زحمت قابلیت‌های تبدیل HTML به PDF را در برنامه‌های NET خود ادغام کنند، گردش کار را ساده‌سازی کنند و دسترسی و قابلیت استفاده محتوای وب را افزایش دهند.

SDK را می توان از NuGet یا GitHub دانلود کرد. اکنون برای نصب SDK از طریق NuGet، لطفاً دستور زیر را در پنجره ترمینال اجرا کنید:

nuget install Aspose.HTML-Cloud

همچنین می توانید بسته را از طریق مدیر بسته NuGet با اجرای دستور زیر نصب کنید:

PM> Install-Package Aspose.HTML-Cloud

ساده ترین روش دیگر نصب SDK از طریق NuGet Package Manager در Visual Studio IDE است.

Solution Explorer را باز کنید.
پروژه را گسترش دهید و روی پوشه Packages در راه حل خود کلیک راست کنید.
گزینه Manage NuGet Packages… را انتخاب کنید.
روی تب Browse کلیک کنید و “Aspose.HTML-Cloud” را جستجو کنید.
روی بسته Aspose.HTML-Cloud کلیک کنید، نسخه مناسب را در تب سمت راست انتخاب کنید و روی دکمه Add Package کلیک کنید.

تصویر 1: - API تبدیل HTML به PDF در NuGet Package Manager.

گام مهم بعدی، اشتراک رایگان خدمات ابری ما از طریق Aspose.Cloud داشبورد با استفاده از GitHub یا حساب Google است. یا، به سادگی یک حساب جدید ایجاد کنید و جزئیات اعتبار مشتری خود را دریافت کنید.

HTML به PDF در C#

این بخش تبدیل صفحه وب به PDF را توضیح می دهد. HTML ورودی قبلاً در فضای ذخیره‌سازی ابری ذخیره می‌شود و پس از تبدیل، فایل حاصل نیز در فضای ذخیره‌سازی ابری ذخیره می‌شود.

ابتدا، لطفاً یک نمونه از HtmlApi ایجاد کنید و جزئیات ClientID و ClientSecret را به عنوان آرگومان ارسال کنید.
در مرحله دوم، محتوای فایل HTML را با استفاده از روش File.OpenRead(..) بخوانید.
سوم، یک نمونه از StorageApi ایجاد کنید و از روش UploadFile(…) برای آپلود HTML ورودی در فضای ذخیره سازی ابری استفاده کنید.
در نهایت، روش PutConvertDocumentToPdf(…) را فراخوانی کنید تا تبدیل HTML به PDF را انجام دهید و خروجی را در فضای ذخیره سازی ابری ذخیره کنید.

// ClientID را از https://dashboard.aspose.cloud/ دریافت کنید
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// رشته URL پایه
const string SERVICE_API_HOST = "https://api.aspose.cloud";

// نمونه HtmlApi ایجاد کنید
HtmlApi htmlApi = new HtmlApi(clientID, clientSecret,SERVICE_API_HOST);

String name = "inputHTML.html";// inpit Document name.
int width = 800; // Resulting image width.
int height = 1000; // Resulting image height.
int leftMargin = 10; // Left resulting image margin.
int rightMargin = 10; // Right resulting image margin.
int topMargin = 10; // Top resulting image margin.
int bottomMargin = 10; // Bottom resulting image margin.

// نام فایل حاصل
string resultantFile = "Resultant.pdf";

try
{
    // فایل را از درایو محلی بارگیری کنید
    using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + name))
    {
        // نمونه StorageApi را ایجاد کنید
        var uploadFileRequest = new StorageApi(clientID, clientSecret, SERVICE_API_HOST);
        
        // فایل HTML را در فضای ذخیره سازی ابری آپلود کنید
        uploadFileRequest.UploadFile(file, "inputHTML.html");
    }
    
    // تبدیل به فرمت PDF را انجام دهید
    // خروجی را در فضای ذخیره سازی ابری ذخیره کنید
    AsposeResponse response = htmlApi.PutConvertDocumentToPdf(
    name, resultantFile, width, height,
    leftMargin, rightMargin, topMargin, bottomMargin);
    
    // پیام موفقیت چاپ در صورت موفقیت آمیز بودن تبدیل
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("HTML successfully converted to PDF !");
    }
}catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}

می توانید فایل های نمونه استفاده شده در مثال بالا را به ترتیب از inputHTML.html و Resultant.pdf دانلود کنید.

با استفاده از دستورات cURL صفحه وب را به PDF تبدیل کنید

تبدیل HTML به PDF با استفاده از دستورات cURL مزایای متعددی را ارائه می دهد. اول، یک روش ساده و سرراست برای شروع فرآیند تبدیل بدون نیاز به کدگذاری یا یکپارچه سازی پیچیده ارائه می کند. ثانیاً، با استفاده از cURL، می‌توانید به راحتی درخواست‌های HTTP را ارسال کنید و پاسخ‌ها را مدیریت کنید، و آن را به گزینه‌ای مناسب برای انجام تبدیل HTML به PDF تبدیل کنید. علاوه بر این، دستورات cURL را می توان به راحتی در اسکریپت ها یا گردش کار اتوماسیون گنجانده و امکان تبدیل دسته ای کارآمد و خودکار را فراهم می کند.

لطفا مراحل زیر را برای انجام تبدیل HTML به PDF دنبال کنید.

Client ID و Client Secret خود را از داشبورد Cloud دریافت کنید.
رمز دسترسی به وب JSON را بر اساس اعتبار مشتری دریافت کنید.
API PutConvertDocumentToPdf را فراخوانی کنید.

اکنون، لطفا دستور cURL زیر را برای تولید نشانه دسترسی JWT اجرا کنید.

 curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=4db2f826-bf9c-42e7-8b2a-8cbca2d15553&client_secret=d757548a9f2558c39c2feebdf85b4c44" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

لطفاً دستور زیر را برای آپلود فایل HTML ورودی در فضای ذخیره سازی ابری اجرا کنید:

curl -X PUT "https://api.aspose.cloud/html/storage/file/inputHTML.html" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: multipart/form-data" \
-d {"File":{}}

اکنون، لطفا دستور زیر را برای ذخیره صفحه وب به عنوان HTML اجرا کنید. سپس فایل حاصل در فضای ذخیره سازی ابری ذخیره می شود.

curl -X PUT "https://api.aspose.cloud/html/inputHTML.html/convert/pdf?outPath=Converted.pdf&width=800&height=1000&leftMargin=10&rightMargin=10&topMargin=10&bottomMargin=10" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

لینک های مفید

صفحه اصلی محصول

کد منبع SDK

مرجع API

مستندات محصول

تالار گفتمان پشتیبانی رایگان محصول

نتیجه گیری

در پایان، تبدیل HTML به PDF یک نیاز حیاتی برای بسیاری از برنامه‌ها است و با در دسترس بودن ابزارهای قدرتمندی مانند Aspose.HTML Cloud SDK برای دستورات NET و cURL، گزینه‌های متعددی برای دستیابی به این کار دارید. خواه سادگی و راحتی یک SDK اختصاصی را ترجیح می دهید یا قابلیت انعطاف پذیری و اتوماسیون دستورات cURL، هر دو رویکرد راه حل های کارآمد و قابل اعتمادی را ارائه می دهند.

بنابراین، چه در حال ساخت برنامه های کاربردی وب، تولید گزارش یا آرشیو محتوای وب باشید، توانایی تبدیل HTML به PDF با استفاده از NET REST API تضمین می کند که می توانید به راحتی و به طور موثر نیازهای کسب و کار خود را برآورده کنید.

مقالات مرتبط

توصیه می کنیم برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید:

HTML به PDF تبدیل REST API#

HTML به PDF در C##

با استفاده از دستورات cURL صفحه وب را به PDF تبدیل کنید#

لینک های مفید#

نتیجه گیری#

مقالات مرتبط#