Перетворіть HTML у PDF за допомогою REST API у Python

Як розробник Python ви можете легко конвертувати свої HTML-файли в PDF-документи програмним шляхом у хмарі. Таке перетворення може бути корисним для ведення записів або обміну файлами HTML у переносимій формі. У цій статті ви дізнаєтесь, як конвертувати документи HTML у PDF за допомогою REST API у Python.

У цій статті будуть розглянуті такі теми:

REST API перетворення HTML у PDF і Python SDK

Для перетворення файлів HTML у PDF я буду використовувати API Python SDK GroupDocs.Conversion Cloud. Це дозволяє конвертувати ваші документи та зображення будь-якого підтримуваного формату файлу у будь-який потрібний формат. Ви можете легко конвертувати понад 50 типів документів і зображень, таких як Word, PowerPoint, Excel, PDF, HTML, CAD, растрові зображення тощо.

Ви можете встановити GroupDocs.Conversion Cloud у свій проект Python за допомогою такої команди в консолі:

pip install groupdocs_conversion_cloud

Будь ласка, отримайте свій ідентифікатор клієнта та секрет клієнта з інформаційної панелі, перш ніж почати виконувати кроки та доступні приклади коду. Отримавши ідентифікатор і секрет, додайте код, як показано нижче:

client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

Перетворіть HTML у PDF за допомогою REST API у Python

Ви можете конвертувати свій HTML-файл у PDF-документ, виконавши прості дії, наведені нижче:

Завантажте документ

По-перше, завантажте файл HTML у хмару, використовуючи наведений нижче приклад коду:

# створити екземпляр API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# запит на завантаження файлу
request = groupdocs_conversion_cloud.UploadFileRequest("sample.html", "C:\\Files\\sample.html", my_storage)

# завантажити файл зразка
response = file_api.upload_file(request)

У результаті завантажений HTML-файл буде доступний у розділі файлів вашої інформаційної панелі в хмарі.

Перетворення HTML у PDF на Python

Ви можете легко програмно конвертувати документи HTML у PDF, виконавши наведені нижче дії.

  • Створіть екземпляр ConvertApi
  • Створіть екземпляр ConvertSettings
  • Встановіть шлях до файлу HTML
  • Призначте формату «pdf».
  • Укажіть шлях до вихідного файлу
  • Визначте PdfConvertOptions, якщо потрібно
  • Додатково встановіть різні властивості, такі як dpi, margin\top, margin\left, fit\window тощо.
  • Створіть ConvertDocumentRequest за допомогою ConvertSettings
  • Отримайте результати, викликавши метод convert\document() за допомогою ConvertDocumentRequest

У наведеному нижче прикладі коду показано, як перетворити файл HTML на документ PDF за допомогою REST API.

# Створіть необхідні екземпляри API
конвертувати_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Підготуйте параметри конвертації
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "конвертуватиed"

# Параметри конвертації PDF
конвертуватиOptions = groupdocs_conversion_cloud.PdfConvertOptions()
конвертуватиOptions.center_window = True     # Set position of the document's window on the screen
конвертуватиOptions.display_doc_title = True
конвертуватиOptions.dpi = 1024.0
конвертуватиOptions.fit_window = False
конвертуватиOptions.from_page = 1           # Start conversion from FromPage page
конвертуватиOptions.linearize = False       # Linearize PDF Document for the Web
конвертуватиOptions.margin_top = 5
конвертуватиOptions.margin_left = 5
конвертуватиOptions.unembed_fonts = True     # Make fonts not embedded
конвертуватиOptions.remove_pdfa_compliance = False # Remove Pdf-A Compliance

settings.конвертувати_options = конвертуватиOptions

# Перетворення запиту на документ
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# конвертувати
result = конвертувати_api.конвертувати_document(request)

# Готово
print("Document конвертуватиed: " + result[0].path)
Перетворіть HTML у PDF за допомогою REST API у Python

Перетворіть HTML у PDF за допомогою REST API у Python

Завантажте конвертований файл

Наведений вище зразок коду збереже перетворений PDF-файл у хмарі. Ви можете завантажити його за допомогою наступного зразка коду:

# Ініціалізація API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# створити запит на завантаження файлу
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# завантажити файл
response = file_api.download_file(request)

# Перемістіть завантажений файл у свій робочий каталог
shutil.move(response, "C:\\Files\\")

Перетворіть HTML у PDF і додайте водяний знак

Ви можете конвертувати HTML-документи в PDF-документи та додавати водяні знаки до конвертованих документів програмним шляхом, виконавши наведені нижче дії.

  • Створіть екземпляр ConvertApi
  • Створіть екземпляр ConvertSettings
  • Встановіть шлях до файлу HTML
  • Призначте формату «pdf».
  • Укажіть шлях до вихідного файлу
  • Створіть екземпляр WatermarkOptions
  • Встановіть текст водяного знака, колір, ширину, висоту тощо.
  • Визначте PdfConvertOptions і призначте WatermarkOptions
  • Створіть ConvertDocumentRequest за допомогою ConvertSettings
  • Перетворіть, викликавши метод convert\document() за допомогою ConvertDocumentRequest

У наведеному нижче прикладі коду показано, як перетворити файл HTML на документ PDF і додати водяний знак до перетвореного документа PDF за допомогою API REST у Python. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файли.

# ініціалізація API
конвертувати_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# визначити параметри конвертації
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "конвертуватиed"

# визначити параметри водяного знака
watermark = groupdocs_conversion_cloud.WatermarkOptions()
watermark.text = "THIS IS SAMPLE WATERMARK"
watermark.bold = True;
watermark.font_size = 34;
watermark.color = "Gray";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;

# визначити параметри перетворення PDF
конвертуватиOptions = groupdocs_conversion_cloud.PdfConvertOptions()
конвертуватиOptions.watermark_options = watermark

settings.конвертувати_options = конвертуватиOptions

# створити запит на конвертацію документа
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# конвертувати
result = конвертувати_api.конвертувати_document(request)
print("Document конвертуватиed successfully: " + result[0].url)
Перетворіть HTML у PDF і додайте водяний знак

Перетворіть HTML у PDF і додайте водяний знак

Перетворення HTML у PDF без використання хмарного сховища

Ви можете конвертувати документи HTML у PDF без використання хмарного сховища, виконавши наведені нижче дії.

  • Створіть екземпляр ConvertApi
  • Створіть ConvertDocumentDirectRequest і передайте запитаний формат документа та шлях до вхідного файлу
  • Отримайте результати, викликавши метод convert\document\direct() за допомогою ConvertDocumentDirectRequest
  • За бажанням збережіть вихідний файл у локальний шлях за допомогою методу shutil.move().

У наведеному нижче прикладі коду показано, як перетворити файл HTML на документ PDF без використання хмарного сховища. Ви передасте вхідний файл у тіло запиту та отримаєте вихідний файл у відповідь API.

# Створіть необхідні екземпляри API
convert_api = groupdocs_conversion_cloud.конвертуватиApi.from_keys(client_id, client_secret)

# Підготувати запит
request = groupdocs_conversion_cloud.конвертуватиDocumentDirectRequest("pdf", "C:\\Files\\sample.html")

# конвертувати
result = convert_api.convert_document_direct(request)

# Перемістіть завантажений файл у свій робочий каталог
shutil.move(result, "C:\\Files\\")

Перетворюйте HTML у PDF і завантажуйте безпосередньо

Ви можете легко програмно конвертувати документи HTML у PDF, виконавши наведені нижче дії.

  • Створіть екземпляр ConvertApi
  • Створіть екземпляр ConvertSettings
  • Встановіть шлях до файлу HTML
  • Призначте формату «pdf».
  • Встановіть «None» для вихідного шляху
  • Створіть ConvertDocumentRequest за допомогою ConvertSettings
  • Отримайте результати, викликавши метод convert\document\download().
  • За бажанням збережіть вихідний файл у локальний шлях за допомогою методу shutil.move().

У наведеному нижче прикладі коду показано, як перетворити файл HTML на документ PDF і завантажити його безпосередньо за допомогою API REST у Python. У відповідь API повертає перетворений PDF-файл. Щоб завантажити файл, виконайте наведені вище дії.

# Створіть необхідні екземпляри API
convert_api = groupdocs_conversion_cloud.конвертуватиApi.from_keys(client_id, client_secret)

# Підготуйте параметри конвертації
settings = groupdocs_conversion_cloud.конвертуватиSettings()
settings.file_path = "sample.html"
settings.format = "pdf"

settings.output_path = None    # leave OutputPath will result the output as document IOStream

# Підготувати запит
request = groupdocs_conversion_cloud.конвертуватиDocumentRequest(settings)

# конвертувати
response = convert_api.convert_document_download(request)

# Перемістіть завантажений файл у свій робочий каталог
shutil.move(response, "C:\\Files\\")

Спробуйте онлайн

Будь ласка, спробуйте наведений нижче безкоштовний онлайн-інструмент для перетворення HTML у PDF, який розроблено за допомогою наведеного вище API. https://products.groupdocs.app/conversion/html-to-pdf

Висновок

У цій статті ви дізналися, як конвертувати файли HTML у документи PDF за допомогою Python у хмарі. Ви також дізналися, як конвертувати HTML-файли в PDF-документи без програмного використання хмарного сховища. Крім того, ви навчилися додавати водяний знак до конвертованих PDF-документів за допомогою Python. У цій статті також пояснюється, як програмно завантажити файл HTML у хмару, а потім завантажити перетворений PDF-файл із хмари. Ви можете дізнатися більше про GroupDocs.Conversion Cloud API, використовуючи документацію. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-яких неясностей зв’яжіться з нами на форумі.

Дивись також