API e SDK Ridimensiona PDF
Controllo programmatico delle dimensioni dei documentiControllo 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 inchesElaborazione 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"
}
Guida all’implementazione
Integrazione via API REST
L'API per il ridimensionamento dei PDF segue i principi RESTful con una struttura di endpoint semplice:
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
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
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.
FAQ
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.