API e SDK Unisci PDF

Combina più documenti PDF in modo programmatico

Trasforma i flussi documentali con una potente fusione PDF

L’API e l’SDK Unisci PDF forniscono agli sviluppatori funzionalità robuste per combinare più file PDF in un documento unico in modo programmatico. Questa soluzione elimina la complessità della manipolazione PDF offrendo un percorso di implementazione immediato, mantenendo al contempo l’integrità completa dei documenti.

Progettata per i team di sviluppo che richiedono affidabilità e prestazioni, la nostra tecnologia di fusione PDF funziona su tutte le piattaforme e i modelli di integrazione. Che tu stia creando applicazioni desktop, servizi web o flussi di lavoro automatizzati, puoi implementare fusioni PDF di livello professionale con un’impronta di codice minima e un consumo limitato di risorse.

A differenza delle librerie documentali generiche che trattano il PDF come un formato qualsiasi, la nostra soluzione dedicata affronta le sfide specifiche della fusione PDF: mantenimento dei segnalibri, preservazione dei campi modulo, gestione dei documenti protetti da password e resa pixel‑perfect nell’output combinato

Caratteristiche tecniche principali

Selezione e ordinamento pagine flessibili

La nostra API Merge PDF offre un controllo granulare su quali pagine includere nel documento finale. Specifica pagine singole, intervalli con trattino (es. “3‑7”) o selezioni separate da virgole per ogni documento sorgente. Le pagine possono essere indicate in qualsiasi ordine nella richiesta, ma appariranno in ordine ascendente nel documento elaborato.

POST/pdf-merge/v1
  items[0].file
  items[0].password
  items[0].pages
  ...

This precision allows you to extract and combine only the relevant content from larger documents, reducing file size and improving document relevance for your users.

Supporto a documenti protetti da password

La sicurezza non deve rappresentare un ostacolo all’elaborazione. L’API Merge PDF gestisce i documenti sorgente protetti da password tramite un semplice parametro nella richiesta. Ogni file sorgente può avere la propria password, permettendo flussi che combinano documenti con impostazioni di sicurezza diverse.

items[0].password
string
The password to open the file

This feature eliminates a common bottleneck in document automation pipelines where protected files typically require manual intervention.

Architettura di elaborazione asincrona

Costruita per l’affidabilità su larga scala, la nostra API implementa un modello di elaborazione asincrona che restituisce subito un ID operazione mentre l’elaborazione continua in background:

{
  "id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
 }
  Check operation status using:

GET/operation/v1/{operationId}/status

This approach prevents timeouts on large documents and enables your application to handle multiple merge operations concurrently without blocking user interactions.

Gestione delle richieste multipart

L’API accetta richieste multipart/form-data, rendendo semplice caricare più file PDF con una sola chiamata. Questa implementazione riduce l’overhead di rete e semplifica il codice lato client rispetto alle API che richiedono passaggi separati di upload ed elaborazione.

multipart/form-data
Max size of all files is 10MB.

Each file in the request can include its own set of parameters, providing maximum flexibility for complex document assembly scenarios.

Funzionalità di importazione batch

Elabora più file in un’unica operazione con la funzionalità di import batch. Non c’è alcun limite artificiale al numero di file che puoi combinare (subordinato soltanto al limite di 10 MB per richiesta).
Combinare report mensili in riepiloghi trimestrali
Unire ricevute di transazione in documenti di estratto conto
Assemblare capitoli in manuali o pubblicazioni completi

Il motore di elaborazione batch mantiene prestazioni costanti indipendentemente dal numero di file in input, con un uso della memoria prevedibile che scala linearmente con la complessità del documento.

Implementazioni cross‑platform

Scegli l’approccio di implementazione che si adatta al tuo stack tecnologico:

  • REST API

    Ideale per applicazioni web e flussi cloud

  • SDK

    Perfetto per applicazioni desktop e scenari offline

Entrambe le opzioni offrono capacità di fusione identiche con qualità di output coerente, assicurando che l’elaborazione documentale funzioni in modo affidabile a prescindere dal modello di distribuzione.

Implementazione tecnica

Panoramica endpoint API

L’endpoint principale per le operazioni di fusione PDF è:

POST/pdf-merge/v1

This endpoint accepts a multipart form request containing the files to merge and their associated parameters.

Struttura della richiesta

Per ciascun file:

File (obbligatorio)

Dati binari PDF

Password (opzionale)

Password per documenti protetti

Pages (opzionale)

Pagine specifiche da includere

I file sono processati nell’ordine indicato (items[0], items[1], ecc.), permettendoti di controllare la sequenza di contenuto nel documento finale.

Gestione della risposta

L’API restituisce una risposta 202 Accepted con un ID operazione all’avvio dell’elaborazione:

{
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Your application should store this ID and poll the operations endpoint to determine when processing is complete:

GET/operation/v1/{operationId}/status

When the operation completes successfully, you'll receive a download URL for the merged document.

Gestione errori

L’API fornisce codici di errore specifici per aiutare a diagnosticare i problemi:

  • 400

    Richiesta non valida (parametri errati, tipi di file non supportati)

  • 401

    Accesso non autorizzato (problemi di autenticazione)

Una corretta gestione degli errori nella tua implementazione dovrebbe considerare queste risposte e fornire agli utenti un feedback appropriato.

Vantaggi tecnici

Flessibilità di integrazione online

La REST API offre diversi vantaggi per implementazioni web:

Compatibile con serverless: Distribuisci in ambienti serverless senza dipendenze da librerie PDF

Supporto cross-browser: Elabora documenti da qualsiasi dispositivo o browser

Integrazione con l’archiviazione cloud: Accetta file direttamente da servizi come Google Drive o Dropbox

Nessuna elaborazione lato client: Scarica le operazioni ad alto utilizzo di CPU sul servizio API

Queste funzionalità rendono l’API ideale per applicazioni SaaS, portali web e sistemi di gestione documentale in cui le risorse lato client possono essere limitate.

Potenza di elaborazione offline

L’implementazione dell’SDK fornisce funzionalità cruciali per applicazioni desktop e server:

Nessuna dipendenza da Internet: Elabora documenti senza connettività di rete

Utilizzo delle risorse locali: Usa le risorse di sistema disponibili per un’elaborazione più rapida

Privacidade dos dados: Mantenha documentos sensíveis dentro do perímetro da sua rede

Integrazione con l’archiviazione locale: Lavora direttamente con i documenti del file system

Questo approccio è particolarmente prezioso per i settori regolamentati, dove i dati devono rimanere in ambienti controllati, o per applicazioni che devono operare in scenari disconnessi.

Conservazione della qualità del documento

A differenza degli strumenti generici che possono perdere la formattazione durante la combinazione, la nostra tecnologia di unione preserva:

  • Dimensioni e orientamento originali delle pagine
  • Ricercabilità e selezione del testo
  • Metadati e proprietà documento
  • Grafica vettoriale di alta qualità
  • Campi modulo e interattività
  • Segnalibri e collegamenti interni

Il risultato è un documento di livello professionale che mantiene tutte le funzionalità dei file sorgente offrendo un’esperienza di lettura unificata.

Perché scegliere la nostra soluzione Merge PDF?

Design orientato agli sviluppatori

La nostra API e il nostro SDK sono realizzati da sviluppatori per sviluppatori, con:

Interfacce pulite e coerenti che seguono i principi REST

Comportamento prevedibile su diversi tipi di documento

Segnalazioni di errore complete per un debug più rapido

Dipendenze minime per ridurre la complessità di integrazione

Questo approccio riduce i tempi di implementazione e l’onere di manutenzione rispetto alle librerie di documenti generiche.

Prestazioni pronte per la produzione

Progettata per applicazioni mission-critical con requisiti stringenti:

Utilizzo della memoria coerente anche con documenti di grandi dimensioni

Tempi di elaborazione prevedibili per la pianificazione delle operazioni

Implementazione thread-safe per l’elaborazione concorrente

Gestione robusta di PDF malformati o danneggiati

Queste caratteristiche rendono la nostra soluzione adatta sia all’elaborazione batch ad alto volume sia alle applicazioni interattive rivolte all’utente.

Controllo completo dei flussi documentali

A differenza delle soluzioni esclusivamente cloud, le nostre due opzioni di implementazione ti offrono:

  • Libertà di scegliere tra API e SDK in base ai requisiti del progetto
  • Possibilità di implementare approcci ibridi (elaborazione online/offline)
  • Pieno controllo della pipeline di elaborazione documentale
  • Opzioni di personalizzazione non disponibili con strumenti generici

Questa flessibilità garantisce che i tuoi flussi documentali possano adattarsi a requisiti aziendali in evoluzione senza rielaborazioni dell’architettura.

Domande frequenti

La qualità dei PDF verrà compromessa dopo la fusione?

No. La nostra tecnologia di unione mantiene il 100 % della qualità originale del documento, inclusa la nitidezza del testo, la risoluzione delle immagini e l’accuratezza dei colori. La grafica vettoriale rimane nitida a prescindere dal livello di zoom.

Come posso unire PDF offline?

L’Avanquest PDF SDK abilita funzionalità complete di unione PDF offline. Implementa il SDK nella tua applicazione per elaborare i documenti in locale senza connessione Internet, mantenendo tutte le funzionalità avanzate disponibili nella versione API.

Come accedo al PDF fuso?

Con l’implementazione tramite API, riceverai un URL di download al termine dell’elaborazione. La tua applicazione può scaricare automaticamente il file oppure mostrare il link agli utenti. Con l’implementazione tramite SDK, puoi salvare il documento unito direttamente in qualsiasi percorso di file accessibile.

Quali sono i limiti di dimensione?

L’API accetta fino a 10 MB di dimensione totale per richiesta. Per documenti più grandi, valuta di suddividere l’operazione di unione in più richieste oppure di usare lo SDK per l’elaborazione locale senza limiti di dimensione.

Posso unire pagine specifiche invece di interi documenti?

Sì. Sia l’API sia lo SDK supportano una selezione granulare delle pagine tramite il parametro «pages». Specifica pagine singole o intervalli di pagine (ad es. «1,3,5-7») per estrarre e unire solo il contenuto necessario da ciascun documento sorgente.

Inizia con la fusione PDF

Implementazione immediata

Registrati per l’accesso all’API: Crea un account sviluppatore per ricevere la tua chiave API

Consulta la documentazione: Accedi alla nostra documentazione di riferimento completa dell’API

Esegui la tua prima richiesta: Usa gli esempi di codice per implementare un’unione di base

Esplora le funzionalità avanzate: Aggiungi la selezione delle pagine e la gestione della sicurezza dei documenti

Risorse sviluppatori

Riferimento API: Documentazione completa degli endpoint

Download dell’SDK: Pacchetti di implementazione specifici per piattaforma

Esempi di codice: esempi funzionanti in più linguaggi

Guide all’integrazione: Tutorial passo-passo per l’implementazione

Inizia oggi a creare potenti flussi documentali con la nostra API e il nostro SDK di unione PDF.