Konversikan HTML ke PDF menggunakan REST API dengan Python

Sebagai pengembang Python, Anda dapat dengan mudah mengonversi file HTML ke dokumen PDF secara terprogram di cloud. Konversi semacam itu dapat membantu dalam menyimpan catatan atau berbagi file HTML dalam bentuk portabel. Pada artikel ini, Anda akan mempelajari cara mengonversi dokumen HTML ke PDF menggunakan REST API dengan Python.

Topik-topik berikut akan dibahas dalam artikel ini:

API REST Konversi HTML ke PDF dan Python SDK

Untuk mengonversi file HTML ke PDF, saya akan menggunakan Python SDK of GroupDocs.Conversion Cloud API. Ini memungkinkan Anda untuk mengonversi dokumen dan gambar dari [format file yang didukung] apa pun 4 ke format apa pun yang Anda butuhkan. Anda dapat dengan mudah mengonversi lebih dari 50 jenis dokumen dan gambar seperti Word, PowerPoint, Excel, PDF, HTML, CAD, gambar raster, dll.

Anda dapat menginstal GroupDocs.Conversion Cloud ke proyek Python Anda menggunakan perintah berikut di konsol:

pip install groupdocs_conversion_cloud

Dapatkan ID Klien dan Rahasia Klien Anda dari dashboard sebelum Anda mulai mengikuti langkah-langkah dan contoh kode yang tersedia. Setelah Anda memiliki ID dan rahasia Anda, silakan tambahkan kode seperti yang ditunjukkan di bawah ini:

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 = ""

Konversikan HTML ke PDF menggunakan REST API dengan Python

Anda dapat mengonversi file HTML Anda menjadi dokumen PDF dengan mengikuti langkah-langkah sederhana yang disebutkan di bawah ini:

Unggah Dokumen

Pertama, unggah file HTML ke cloud menggunakan contoh kode yang diberikan di bawah ini:

# membuat instance API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# permintaan unggah file
request = groupdocs_conversion_cloud.UploadFileRequest("sample.html", "C:\\Files\\sample.html", my_storage)

# mengunggah file contoh
response = file_api.upload_file(request)

Hasilnya, file HTML yang diunggah akan tersedia di files section dasbor Anda di cloud.

Konversikan HTML ke PDF dengan Python

Anda dapat dengan mudah mengonversi dokumen HTML ke PDF secara terprogram dengan mengikuti langkah-langkah berikut:

  • Buat instance ConvertApi
  • Buat instance dari ConvertSettings
  • Setel jalur file HTML
  • Tetapkan “pdf” ke format
  • Berikan jalur file keluaran
  • Tentukan PdfConvertOptions jika diperlukan
  • Opsional atur berbagai properti seperti dpi, margin\top, margin\left, fit\window, dll.
  • Buat ConvertDocumentRequest dengan ConvertSettings
  • Dapatkan hasil dengan memanggil metode convert\document() dengan ConvertDocumentRequest

Contoh kode berikut menunjukkan cara mengonversi file HTML Anda ke dokumen PDF menggunakan REST API.

# Buat instance API yang diperlukan
mengubah_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Siapkan pengaturan konversi
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "mengubahed"

# Opsi konversi PDF
mengubahOptions = groupdocs_conversion_cloud.PdfConvertOptions()
mengubahOptions.center_window = True     # Set position of the document's window on the screen
mengubahOptions.display_doc_title = True
mengubahOptions.dpi = 1024.0
mengubahOptions.fit_window = False
mengubahOptions.from_page = 1           # Start conversion from FromPage page
mengubahOptions.linearize = False       # Linearize PDF Document for the Web
mengubahOptions.margin_top = 5
mengubahOptions.margin_left = 5
mengubahOptions.unembed_fonts = True     # Make fonts not embedded
mengubahOptions.remove_pdfa_compliance = False # Remove Pdf-A Compliance

settings.mengubah_options = mengubahOptions

# Konversi permintaan dokumen
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# mengubah
result = mengubah_api.mengubah_document(request)

# Selesai
print("Document mengubahed: " + result[0].path)
Konversikan HTML ke PDF menggunakan REST API dengan Python

Konversikan HTML ke PDF menggunakan REST API dengan Python

Unduh File yang Dikonversi

Contoh kode di atas akan menyimpan file PDF yang dikonversi di cloud. Anda dapat mengunduhnya menggunakan contoh kode berikut:

# inisialisasi API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# buat permintaan file unduhan
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# Unduh berkas
response = file_api.download_file(request)

# Pindahkan file yang diunduh ke direktori kerja Anda
shutil.move(response, "C:\\Files\\")

Konversikan HTML ke PDF dan Tambahkan Tanda Air

Anda dapat mengonversi dokumen HTML ke PDF dan menambahkan tanda air ke dokumen yang dikonversi secara terprogram dengan mengikuti langkah-langkah di bawah ini:

  • Buat instance dari ConvertApi
  • Buat instance dari ConvertSettings
  • Setel jalur file HTML
  • Tetapkan “pdf” ke format
  • Berikan jalur file keluaran
  • Buat instance dari WatermarkOptions
  • Atur Teks Tanda Air, Warna, Lebar, Tinggi, dll.
  • Tentukan PdfConvertOptions dan tetapkan WatermarkOptions
  • Buat ConvertDocumentRequest dengan ConvertSettings
  • Konversikan dengan memanggil metode convert\document() dengan ConvertDocumentRequest

Contoh kode berikut menunjukkan cara mengonversi file HTML ke dokumen PDF dan menambahkan tanda air ke dokumen PDF yang dikonversi menggunakan REST API dengan Python. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.

# inisialisasi api
mengubah_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# menentukan pengaturan konversi
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "mengubahed"

# menentukan opsi tanda air
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;

# tentukan opsi konversi PDF
mengubahOptions = groupdocs_conversion_cloud.PdfConvertOptions()
mengubahOptions.watermark_options = watermark

settings.mengubah_options = mengubahOptions

# buat permintaan konversi dokumen
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# mengubah
result = mengubah_api.mengubah_document(request)
print("Document mengubahed successfully: " + result[0].url)
Konversikan HTML ke PDF dan Tambahkan Tanda Air

Konversikan HTML ke PDF dan Tambahkan Tanda Air

Konversi HTML ke PDF tanpa menggunakan Cloud Storage

Anda dapat mengonversi dokumen HTML ke PDF tanpa menggunakan penyimpanan cloud dengan mengikuti langkah-langkah berikut:

  • Buat instance dari ConvertApi
  • Buat ConvertDocumentDirectRequest dan berikan format dokumen yang diminta dan jalur file input
  • Dapatkan hasil dengan memanggil metode convert\document\direct() dengan ConvertDocumentDirectRequest
  • Secara opsional, simpan file keluaran ke jalur lokal menggunakan metode shutil.move()

Contoh kode berikut menunjukkan cara mengonversi file HTML ke dokumen PDF tanpa menggunakan penyimpanan cloud. Anda akan meneruskan file input di badan permintaan dan menerima file output di respons API.

# Buat instance API yang diperlukan
convert_api = groupdocs_conversion_cloud.MengubahApi.from_keys(client_id, client_secret)

# Siapkan permintaan
request = groupdocs_conversion_cloud.MengubahDocumentDirectRequest("pdf", "C:\\Files\\sample.html")

# Mengubah
result = convert_api.convert_document_direct(request)

# Pindahkan file yang diunduh ke direktori kerja Anda
shutil.move(result, "C:\\Files\\")

Konversikan HTML ke PDF dan Unduh Langsung

Anda dapat dengan mudah mengonversi dokumen HTML ke PDF secara terprogram dengan mengikuti langkah-langkah berikut:

  • Buat instance ConvertApi
  • Buat instance dari ConvertSettings
  • Setel jalur file HTML
  • Tetapkan “pdf” ke format
  • Setel “Tidak Ada” ke jalur keluaran
  • Buat ConvertDocumentRequest dengan ConvertSettings
  • Dapatkan hasil dengan memanggil metode convert\document\download().
  • Secara opsional, simpan file keluaran ke jalur lokal menggunakan metode shutil.move()

Contoh kode berikut menunjukkan cara mengonversi file HTML ke dokumen PDF dan mengunduhnya langsung menggunakan REST API dengan Python. API akan mengembalikan file PDF yang dikonversi sebagai tanggapan. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah file.

# Buat instance API yang diperlukan
convert_api = groupdocs_conversion_cloud.MengubahApi.from_keys(client_id, client_secret)

# Siapkan pengaturan konversi
settings = groupdocs_conversion_cloud.MengubahSettings()
settings.file_path = "sample.html"
settings.format = "pdf"

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

# Siapkan permintaan
request = groupdocs_conversion_cloud.MengubahDocumentRequest(settings)

# Mengubah
response = convert_api.convert_document_download(request)

# Pindahkan file yang diunduh ke direktori kerja Anda
shutil.move(response, "C:\\Files\\")

Coba Daring

Silakan coba alat konversi HTML ke PDF online gratis berikut, yang dikembangkan menggunakan API di atas. https://products.groupdocs.app/conversion/html-to-pdf

Kesimpulan

Pada artikel ini, Anda telah mempelajari cara mengonversi file HTML ke dokumen PDF menggunakan Python di cloud. Anda juga telah mempelajari cara mengonversi file HTML ke dokumen PDF tanpa menggunakan penyimpanan cloud secara terprogram. Selain itu, Anda telah mempelajari cara menambahkan watermark ke dokumen PDF yang dikonversi menggunakan Python. Artikel ini juga menjelaskan cara mengunggah file HTML ke cloud secara terprogram dan kemudian mengunduh file PDF yang dikonversi dari cloud. Anda dapat mempelajari lebih lanjut tentang GroupDocs.Conversion Cloud API menggunakan dokumentasi. Kami juga menyediakan bagian Referensi API yang memungkinkan Anda memvisualisasikan dan berinteraksi dengan API kami secara langsung melalui browser. Jika ada ambiguitas, jangan ragu untuk menghubungi kami di forum.

Lihat juga