API e SDK Ridimensiona PDF

Controllo programmatico delle dimensioni dei documenti

Controllo potente delle dimensioni dei documenti a portata di mano

L’API Ridimensiona PDF offre agli sviluppatori il controllo programmatico sulle dimensioni dei documenti PDF, consentendo regolazioni precise per soddisfare requisiti di output specifici. Pensata per i team di sviluppo che devono integrare funzionalità robuste di ridimensionamento, questa API mantiene la chiarezza e l’integrità della formattazione offrendo al contempo un controllo granulare su dimensioni, margini e selezione pagine.

Che tu stia costruendo pipeline di elaborazione documentale, piattaforme editoriali o sistemi di gestione, la nostra API fornisce le basi tecniche per implementare un ridimensionamento PDF personalizzato con pochissime righe di codice. A differenza delle librerie PDF generiche che richiedono configurazioni estese, la nostra soluzione dedicata garantisce prestazioni elevate e risultati prevedibili su tutti i tipi di documento.

A differenza delle librerie PDF generiche che richiedono una configurazione estesa o delle soluzioni basate su cloud con opzioni di personalizzazione limitate, la nostra API per il ridimensionamento dei PDF offre una soluzione mirata e ad alte prestazioni per la manipolazione delle dimensioni dei documenti con risultati prevedibili su tutti i tipi di documento.

Caratteristiche tecniche principali

Controllo dimensioni di precisione

Imposta larghezza e altezza esatte con precisione decimale (da 0,1 a 200 pollici). Il valore predefinito è A4 (8,3 × 11,7 pollici), ma puoi definire qualsiasi dimensione per soddisfare requisiti di stampa, visualizzazione digitale o modelli personalizzati.

width: number($float)
The width in inches. Value range: 0.1-200 inches. Default: 8.3 inches

height: number($float)
The height in inches. Value range: 0.1-200 inches. Default: 11.7 inches

Elaborazione selettiva delle pagine

Elabora pagine specifiche all'interno di documenti multipagina definendo intervalli di pagine esatti e singole pagine. L'API supporta numeri di pagina separati da virgole e intervalli con trattino (ad es. "1,3,5-7"), offrendo un controllo preciso su quali pagine ridimensionare. Questo approccio mirato è particolarmente prezioso quando si lavora con documenti in cui solo alcune sezioni richiedono la regolazione delle dimensioni.

pages: string
Format examples:"1,3,5"or"1-3,7"or"1,3-5,7-9"

Pages appear in ascending order in the output regardless of input order

Supporto a PDF protetti da password

Elabora senza problemi i PDF protetti fornendo la password del documento come parametro. Questa funzione elimina le interruzioni del flusso di lavoro durante la gestione di documenti protetti e mantiene i protocolli di sicurezza durante l'intero processo. L'API gestisce l'autenticazione in modo trasparente, consentendo alla tua applicazione di mantenere un'elaborazione continua dei documenti.

password: string
The password to open the protected PDF file

Architettura di elaborazione asincrona

L'API implementa un modello di elaborazione asincrona, restituendo immediatamente un ID operazione mentre l'elaborazione continua in background. Questa architettura previene le operazioni di blocco e consente una gestione efficiente di documenti di grandi dimensioni. Monitora lo stato dell'operazione tramite l'endpoint /operation/v1/{operationId}/status per determinare quando l'elaborazione è completa.

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

Gestione margini personalizzati

Definisci margini non uniformi per creare documenti con requisiti di layout specifici. Imposta misurazioni diverse per i margini superiore, inferiore, sinistro e destro in modo indipendente, per soddisfare formati di documenti specializzati o requisiti di stampa. Questo controllo granulare consente una formattazione precisa dei documenti che soddisfa le specifiche esatte per un output professionale.

Ad esempio, è possibile creare documenti con:
Spazio di rilegatura extra sul margine sinistro
Margini bilanciati per contenuti centrati
Margini minimi per la massima area di contenuto
Spazio personalizzato per intestazione/piè di pagina con margini superiore/inferiore espansi

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.

Preservazione dell’integrità del documento

L'API mantiene la fedeltà visiva durante le operazioni di ridimensionamento, preservando la chiarezza del testo, la qualità delle immagini e la precisione della grafica vettoriale. Questo approccio tecnico garantisce che i documenti ridimensionati rimangano professionali e leggibili indipendentemente dalle modifiche alle dimensioni applicate. Il rendering dei caratteri, la risoluzione delle immagini e il posizionamento degli elementi vengono tutti accuratamente preservati durante il processo di trasformazione.

Guida all’implementazione

Integrazione API RESTful

L'API per il ridimensionamento dei PDF segue i principi RESTful con una struttura di endpoint semplice:

POST/resize-pdf/v1

L'API accetta multipart/form-data con i seguenti parametri:

file: Il file PDF da ridimensionare (binario, max 10 MB)

password: Password opzionale per i documenti protetti

pages: Selezione di pagine opzionale (ad es. "1,3,5-7")

width: Larghezza opzionale in pollici (0,1-200, predefinita 8,3)

height: Altezza opzionale in pollici (0,1-200, predefinita 11,7)

I codici di risposta forniscono informazioni di stato chiare:

202: Successo, restituisce l'ID dell'operazione

400: Parametri della richiesta non validi

401: Errore di autenticazione

413: Il file supera il limite di dimensione

Implementazione SDK

Per gli sviluppatori che preferiscono l'integrazione diretta della libreria rispetto alle chiamate API, il nostro SDK fornisce la stessa funzionalità con binding in linguaggio nativo. L'SDK offre ulteriori vantaggi, tra cui:

  • Overhead di rete ridotto per l'elaborazione di grandi volumi

  • Monitoraggio dell'avanzamento per le operazioni a lunga esecuzione

  • Gestione degli errori e logica di tentativi semplificata

  • Comportamento multipiattaforma coerente

  • Convalida automatica dei parametri

Come funziona il ridimensionamento PDF

1. Caricamento documento

Seleziona un file PDF da ridimensionare caricandolo dal tuo sistema locale o da un servizio di archiviazione cloud (Google Drive, Dropbox, ecc.). L'API accetta caricamenti diretti di file o riferimenti a file, supportando documenti fino a 10 MB di dimensione. Per l'integrazione programmatica, implementa un caricamento di modulo multipart standard o fornisci un flusso di file direttamente all'endpoint dell'API.

2. Configurazione parametri

Specifica le dimensioni del documento e le opzioni di elaborazione desiderate:
Impostare le misure esatte di larghezza e altezza (in pollici)
Definire margini personalizzati per un controllo preciso del layout
Specificare quali pagine elaborare (tutte le pagine per impostazione predefinita)
Fornire la password per i documenti protetti, se necessario

3. Elaborazione e recupero

L'API elabora il tuo documento in base ai parametri specificati e rende disponibile per il download il PDF ridimensionato. Per le operazioni asincrone, monitora l'endpoint dello stato dell'operazione fino al completamento dell'elaborazione, quindi recupera il documento finito. Tutti i file elaborati vengono rimossi automaticamente dopo il download per mantenere la sicurezza dei documenti.

Lo sapevi?

I margini non sono un'invenzione moderna. Anche i nostri antenati usavano i margini per aiutarli a formattare il testo! I margini furono usati per la prima volta negli antichi rotoli di papiro egiziani. Poiché i rotoli venivano srotolati orizzontalmente, le colonne di testo erano separate da margini per indicare al lettore quando passare alla riga successiva.

Vantaggi tecnici

Confronto tra SDK e SaaS

Capacità
Luogo di elaborazione
SDK Ridimensiona PDF
In sede o cloud privato
Alternative SaaS
Server del fornitore
Capacità
Privacy documento
SDK Ridimensiona PDF
I file non lasciano mai la tua infrastruttura
Alternative SaaS
Documenti trasmessi a terzi
Capacità
Profondità integrazione
SDK Ridimensiona PDF
Chiamate dirette alla libreria
Alternative SaaS
Richieste API su HTTP
Capacità
Funzionamento offline
SDK Ridimensiona PDF
Completamente funzionante senza internet
Alternative SaaS
Richiede una connettività costante
Capacità
Personalizzazione
SDK Ridimensiona PDF
Accesso completo alla pipeline di elaborazione
Alternative SaaS
Limitato ai parametri API forniti
Capacità
Prestazioni
SDK Ridimensiona PDF
Nessuna latenza di rete per il trasferimento di file
Alternative SaaS
Dipendente dalla connessione a Internet
Capacità
Elaborazione di volumi
SDK Ridimensiona PDF
Limitato solo dalle risorse locali
Alternative SaaS
Spesso soggetto a limitazione di velocità

Flessibilità di deployment

La soluzione Ridimensiona PDF supporta più modelli di implementazione per adattarsi ai requisiti della tua infrastruttura:

  • Implementazione basata su container per architetture a microservizi
  • Integrazione server per server applicativi tradizionali
  • Implementazione di funzioni serverless per piattaforme cloud
  • Incorporamento di applicazioni desktop per l'elaborazione lato client
  • Integrazione della pipeline CI/CD per flussi di lavoro documentali automatizzati

Questa flessibilità garantisce la possibilità di implementare le funzionalità di ridimensionamento dei PDF nell'ambiente che meglio si adatta al proprio stack tecnico e ai propri requisiti di sicurezza.

Funzionalità PDF complementari

Compressione PDF

Combina il ridimensionamento con la compressione per ridurre ulteriormente le dimensioni dei file mantenendo la qualità del documento. I nostri strumenti di compressione riducono in modo intelligente le dimensioni dei file PDF ottimizzando le strutture interne, rimuovendo le ridondanze e applicando algoritmi di compressione sensibili al contenuto. Questa combinazione è particolarmente efficace per la preparazione di documenti per la distribuzione web o la trasmissione via e-mail.

Conversione di formato

Trasforma i documenti tra PDF e altri formati come parte del tuo flusso di lavoro documentale. I nostri strumenti di conversione supportano la trasformazione bidirezonale tra i formati PDF e Microsoft Office (Word, Excel, PowerPoint) e i formati di immagine più comuni. Questa funzionalità consente di creare pipeline di elaborazione dei documenti complete in grado di accettare più formati di input e di produrre un output standardizzato.

Domande frequenti

Come cambio le dimensioni di un PDF?

Dopo aver caricato il PDF tramite l'API, specifica le nuove dimensioni utilizzando i parametri di larghezza e altezza (in pollici). L'API ridimensionerà il documento in base a queste specifiche, mantenendo la qualità e la formattazione del contenuto.

Posso ridimensionare solo alcune pagine?

L'API di ridimensionamento dei PDF adatta le dimensioni del PDF preservando la qualità di immagini, caratteri e altri contenuti. Per ridurre le dimensioni dei file, combina la regolazione delle dimensioni con la nostra API di compressione dei PDF, che riduce le dimensioni effettive dei file tramite tecniche di compressione sensibili al contenuto.

Quanto è sicuro il processo?

Diamo la priorità alla sicurezza dei documenti durante l'intera pipeline di elaborazione. Tutti i file vengono elaborati in ambienti isolati, trasmessi tramite protocolli sicuri e rimossi automaticamente dopo l'elaborazione. Per la massima sicurezza, considera l'opzione di implementazione dell'SDK, che mantiene tutti i documenti all'interno della tua infrastruttura.

Potrebbero essere applicate limitazioni di dimensioni e di utilizzo giornaliero in base al livello di servizio.

Inizia