Unisci PDF in Python

Le operazioni di divisione e unione PDF sono solitamente offerte in software a pagamento e la maggior parte dei visualizzatori PDF gratuiti non fornisce queste funzionalità. Inoltre, nel caso in cui sia necessario unire determinati documenti PDF, è necessario prima installare, configurare e acquistare l’abbonamento completo alla licenza. Potresti avere solo la necessità di unire i file PDF, ma dovrai pagare il prezzo completo della licenza. A parte questo, potresti imbatterti in uno scenario in cui è necessario combinare i file PDF, ma il software non è disponibile su una piattaforma specifica. Pertanto, per mitigare tutti questi scenari, consigliamo di utilizzare Aspose.PDF Cloud API per unire i file PDF online. Non è richiesto alcun download o installazione di software ed eseguire tutte le operazioni nel cloud.

API di elaborazione PDF in Python

Aspose.PDF Cloud SDK per Python è un wrapper attorno ad Aspose.PDF Cloud API che offre tutti i poteri e le capacità di elaborazione dei file PDF per gli sviluppatori Python. Allo stesso modo, l’SDK fornisce anche la funzionalità di unire/combinare più file PDF in un singolo documento di output e tutto questo può essere realizzato con poche righe di codice.

Installazione

Prima di procedere oltre, il primo passo è installare l’SDK dal repository PIP o GitHub. In questo articolo, discuteremo i passaggi dell’installazione da PIP. Basta eseguire il seguente comando sul terminale/prompt dei comandi per installare l’ultima versione dell’SDK sul sistema.

pip install asposepdfcloud

Installazione in Pycharm

PyCharm è un IDE popolare per lo sviluppo Python. Quindi, per usare l’SDK direttamente in Python IDE, segui i passaggi indicati di seguito.

Fare clic sulla voce di menu Preferenze nel menu PyCharm.

Voce di menu Preferenze

Dall’albero a sinistra, seleziona Python Interpreter nella sezione Progetto.

Opzione interprete Python

Ora fai clic sul segno + (più) nella sezione a destra e inserisci asposepdfcloud nel campo di ricerca sopra la finestra di dialogo dei pacchetti disponibili.

Finestra di dialogo dei pacchetti disponibili

Ora fai clic sul pulsante Installa pacchetto. Una volta installato l’SDK, viene visualizzato il messaggio di successo.

Unisci file PDF in Python

Aspose.PDF Cloud utilizza servizi di archiviazione basati su cloud per l’archiviazione dei documenti. Pertanto, per garantire l’integrità e la privacy dei dati, solo le persone autorizzate possono accedere alle API. Quindi il primo passo è creare un account visitando Aspose.Cloud dashboard. Se hai un account GitHub o Google, registrati semplicemente. Altrimenti, fai clic sul pulsante Crea un nuovo account e fornisci le informazioni richieste. Ora accedi alla dashboard utilizzando le credenziali ed espandi la sezione Applicazioni dalla dashboard e scorri verso il basso fino alla sezione Credenziali client per vedere i dettagli ID client e Segreto client.

Di seguito sono riportati i passaggi per unire i documenti PDF.

  • Per prima cosa, crea un oggetto ApiClient passando ClientSecret e ClientID come argomenti.
  • In secondo luogo, creare un’istanza PdfApi passando l’oggetto ApiClient come argomento.
  • Quindi creiamo un oggetto Opts in cui definiamo il PDF di destinazione da aggiungere, la pagina iniziale e finale del file PDF.
  • Infine, chiamare il metodo postappenddocument(…) per eseguire operazioni di unione PDF.
# Ottieni il tuo ClientId e ClientSecret da https://dashboard.aspose.cloud (è richiesta la registrazione gratuita).

#initialize PdfApi client instance using ClientID and ClientSecret
pdf_api_client = asposepdfcloud.api_client.ApiClient("d87269aade6a46cdc295b711e26809af", "a41d01ef-dfd5-4e02-ad29-bd85fe41e3e4")

# crea un'istanza di PdfApi passando PdfApiClient come argomento
pdf_api = PdfApi(pdf_api_client)

# Documento PDF di origine
file_name = 'PdfWithAnnotations.pdf'

# File PDF le cui pagine devono essere aggiunte
append_file_name = 'PdfWithTable.pdf'

# crea opzioni istanza definizione concatenazione PDF
# pagina iniziale e finale del file di concatenazione
opts = {
    "append_file": append_file_name,
    "start_page": 1,
    "end_page": 2
}

# Chiama l'API per unire le pagine
response = pdf_api.post_append_document(file_name, **opts)

# renderizza il codice di risposta nella console
print(response)

Unisci file PDF utilizzando il comando cURL

I comandi cURL sono uno dei modi più comodi per accedere alle API REST tramite il terminale della riga di comando di qualsiasi piattaforma. Non è nemmeno necessario installare l’SDK, ma è sufficiente eseguire il comando nell’applicazione terminale e soddisfare i requisiti. Quindi, per utilizzare i comandi cURL, il primo passaggio è generare JSON Web Token (JWT) in modo che le API siano accessibili tramite il prompt dei comandi. Lo stesso token JWT viene utilizzato per accedere alle API tramite i comandi cURL.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=a41d01ef-dfd5-4e02-ad29-bd85fe41e3e4&client_secret=d87269aade6a46cdc295b711e26809af" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Utilizzare il seguente comando e il PDF di destinazione viene unito ai file PDF di origine/input utilizzando l’API PostAppendDocument. L’output risultante viene salvato nell’archiviazione Cloud.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/appendDocument?appendFile=PdfWithTable.pdf&startPage=2&endPage=3" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

Conclusione

In questo articolo, abbiamo discusso i passaggi per eseguire operazioni di unione PDF utilizzando Python REST API. Grazie al tipo open source, il codice sorgente completo dell’SDK può essere scaricato dal repository GitHub.

Per maggiori dettagli sulle capacità dell’SDK, visita il seguente argomento della documentazione Aspose.PDF Cloud Features. Tuttavia, se riscontri problemi durante l’utilizzo dell’API, non esitare a contattarci tramite un forum di supporto tecnico gratuito.

Articoli correlati

Ti consigliamo inoltre di leggere i seguenti articoli che spiegano: