Converti HTML in PDF utilizzando l'API REST in Python

In qualità di sviluppatore Python, puoi convertire facilmente i tuoi file HTML in documenti PDF in modo programmatico sul cloud. Tale conversione può essere utile per tenere registri o condividere file HTML in una forma portatile. In questo articolo imparerai come convertire HTML in documenti PDF utilizzando un’API REST in Python.

In questo articolo saranno trattati i seguenti argomenti:

Conversione da HTML a PDF REST API e Python SDK

Per convertire i file HTML in PDF, utilizzerò l’API Python SDK di GroupDocs.Conversion Cloud. Ti consente di convertire i tuoi documenti e immagini di qualsiasi formato di file supportato in qualsiasi formato di cui hai bisogno. Puoi convertire facilmente tra oltre 50 tipi di documenti e immagini come Word, PowerPoint, Excel, PDF, HTML, CAD, immagini raster, ecc.

Puoi installare GroupDocs.Conversion Cloud nel tuo progetto Python utilizzando il seguente comando nella console:

pip install groupdocs_conversion_cloud

Si prega di ottenere l’ID cliente e il segreto cliente dalla dashboard prima di iniziare a seguire i passaggi e gli esempi di codice disponibili. Una volta che hai il tuo ID e segreto, aggiungi il codice come mostrato di seguito:

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

Converti HTML in PDF utilizzando l’API REST in Python

Puoi convertire il tuo file HTML in documenti PDF seguendo i semplici passaggi indicati di seguito:

Carica il documento

Innanzitutto, carica il file HTML nel cloud utilizzando l’esempio di codice fornito di seguito:

# creare un'istanza dell'API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# richiesta di caricamento del file
request = groupdocs_conversion_cloud.UploadFileRequest("sample.html", "C:\\Files\\sample.html", my_storage)

# caricare file di esempio
response = file_api.upload_file(request)

Di conseguenza, il file HTML caricato sarà disponibile nella sezione file della dashboard sul cloud.

Converti HTML in PDF in Python

È possibile convertire facilmente i documenti HTML in PDF a livello di programmazione seguendo i passaggi indicati di seguito:

  • Crea un’istanza di ConvertApi
  • Crea un’istanza di ConvertSettings
  • Imposta il percorso del file HTML
  • Assegna “pdf” al formato
  • Fornire il percorso del file di output
  • Definire PdfConvertOptions se necessario
  • Opzionalmente imposta varie proprietà come dpi, margin\top, margin\left, fit\window, ecc.
  • Crea ConvertDocumentRequest con ConvertSettings
  • Ottieni risultati chiamando il metodo convert\document() con ConvertDocumentRequest

L’esempio di codice seguente mostra come convertire il file HTML in un documento PDF utilizzando un’API REST.

# Crea le istanze API necessarie
convertire_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Preparare le impostazioni di conversione
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "convertireed"

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

settings.convertire_options = convertireOptions

# Converti richiesta documento
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# convertire
result = convertire_api.convertire_document(request)

# Fatto
print("Document convertireed: " + result[0].path)
Converti HTML in PDF utilizzando l'API REST in Python

Converti HTML in PDF utilizzando l’API REST in Python

Scarica il file convertito

L’esempio di codice precedente salverà il file PDF convertito sul cloud. Puoi scaricarlo utilizzando il seguente esempio di codice:

# Inizializzazione dell'API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# creare richiesta di file di download
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# download file
response = file_api.download_file(request)

# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\")

Converti HTML in PDF e aggiungi filigrana

È possibile convertire HTML in documenti PDF e aggiungere filigrane ai documenti convertiti in modo programmatico seguendo i passaggi indicati di seguito:

  • Crea un’istanza di ConvertApi
  • Crea un’istanza di ConvertSettings
  • Imposta il percorso del file HTML
  • Assegna “pdf” al formato
  • Fornire il percorso del file di output
  • Crea un’istanza di WatermarkOptions
  • Imposta il testo della filigrana, il colore, la larghezza, l’altezza, ecc.
  • Definire PdfConvertOptions e assegnare WatermarkOptions
  • Crea ConvertDocumentRequest con ConvertSettings
  • Converti chiamando il metodo convert\document() con ConvertDocumentRequest

L’esempio di codice seguente mostra come convertire un file HTML in un documento PDF e aggiungere una filigrana al documento PDF convertito utilizzando un’API REST in Python. Si prega di seguire i passaggi menzionati in precedenza per caricare e scaricare i file.

# inizializzazione dell'API
convertire_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# definire le impostazioni di conversione
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "convertireed"

# definire le opzioni della filigrana
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;

# definire le opzioni di conversione PDF
convertireOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertireOptions.watermark_options = watermark

settings.convertire_options = convertireOptions

# creare la richiesta di conversione del documento
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# convertire
result = convertire_api.convertire_document(request)
print("Document convertireed successfully: " + result[0].url)
Converti HTML in PDF e aggiungi filigrana

Converti HTML in PDF e aggiungi filigrana

Conversione da HTML a PDF senza utilizzare Cloud Storage

È possibile convertire documenti HTML in PDF senza utilizzare l’archiviazione cloud seguendo i passaggi indicati di seguito:

  • Crea un’istanza di ConvertApi
  • Crea ConvertDocumentDirectRequest e passa il formato del documento richiesto e il percorso del file di input
  • Ottieni risultati chiamando il metodo convert\document\direct() con ConvertDocumentDirectRequest
  • Facoltativamente, salva il file di output nel percorso locale utilizzando il metodo shutil.move()

L’esempio di codice seguente mostra come convertire un file HTML in un documento PDF senza utilizzare l’archiviazione cloud. Passerai il file di input nel corpo della richiesta e riceverai il file di output nella risposta API.

# Crea le istanze API necessarie
convert_api = groupdocs_conversion_cloud.ConvertireApi.from_keys(client_id, client_secret)

# Prepara la richiesta
request = groupdocs_conversion_cloud.ConvertireDocumentDirectRequest("pdf", "C:\\Files\\sample.html")

# Convertire
result = convert_api.convert_document_direct(request)

# Sposta il file scaricato nella tua directory di lavoro
shutil.move(result, "C:\\Files\\")

Converti HTML in PDF e scarica direttamente

È possibile convertire facilmente i documenti HTML in PDF a livello di programmazione seguendo i passaggi indicati di seguito:

  • Crea un’istanza di ConvertApi
  • Crea un’istanza di ConvertSettings
  • Imposta il percorso del file HTML
  • Assegna “pdf” al formato
  • Impostare “Nessuno” sul percorso di output
  • Crea ConvertDocumentRequest con ConvertSettings
  • Ottieni risultati chiamando il metodo convert\document\download().
  • Facoltativamente, salva il file di output nel percorso locale utilizzando il metodo shutil.move()

L’esempio di codice seguente mostra come convertire un file HTML in un documento PDF e scaricarlo direttamente usando un’API REST in Python. L’API restituirà il file PDF convertito in risposta. Si prega di seguire i passaggi menzionati in precedenza per caricare un file.

# Crea le istanze API necessarie
convert_api = groupdocs_conversion_cloud.ConvertireApi.from_keys(client_id, client_secret)

# Preparare le impostazioni di conversione
settings = groupdocs_conversion_cloud.ConvertireSettings()
settings.file_path = "sample.html"
settings.format = "pdf"

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

# Prepara la richiesta
request = groupdocs_conversion_cloud.ConvertireDocumentRequest(settings)

# Convertire
response = convert_api.convert_document_download(request)

# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\")

Prova in linea

Prova il seguente strumento online gratuito di conversione da HTML a PDF, sviluppato utilizzando l’API di cui sopra. https://products.groupdocs.app/conversion/html-to-pdf

Conclusione

In questo articolo, hai imparato come convertire i file HTML in documenti PDF usando Python sul cloud. Hai anche imparato a convertire i file HTML in documenti PDF senza utilizzare l’archiviazione cloud a livello di programmazione. Inoltre, hai imparato come aggiungere una filigrana ai documenti PDF convertiti usando Python. Questo articolo spiega anche come caricare in modo programmatico il file HTML nel cloud e quindi scaricare il file PDF convertito dal cloud. Puoi saperne di più su GroupDocs.Conversion Cloud API utilizzando la documentazione. Forniamo anche una sezione Riferimento API che ti consente di visualizzare e interagire con le nostre API direttamente attraverso il browser. In caso di ambiguità, non esitate a contattarci sul forum.

Guarda anche