Linearizzare PDF

PDF4me Linearizzare PDF è un REST punto finale che ristruttura un PDF per una visualizzazione web veloce. POST il file come Base64 A /api/v2/LinearizePdf con un optimizeProfilee il API riordina i suoi oggetti interni in modo che la prima pagina venga renderizzata mentre il resto è ancora in fase di download, quindi restituisce la linearizzata PDF come byte grezzi. Nove profili coprono web, stampa e compressione.

Cosa fa questo endpoint

Prende un PDF e restituisce lo stesso documento riorganizzato per il caricamento progressivo: le informazioni sulla directory e le risorse della pagina 1 si spostano all'inizio del file, in modo che un browser o un visualizzatore incorporato mostri la prima pagina quasi immediatamente invece di attendere l'intero download. pages loro stessi sono intatti. Ideale per portali di documenti, CDN e qualsiasi PDF coperto HTTP.

Autenticazione del tuo API Richiesta

Ogni PDF4me REST la chiamata deve includere il tuo API chiave nel Authorization Intestazione come autenticazione di base. Ottieni o ruota la tua chiave dalla dashboard dello sviluppatore.

Get your API Key

Punto finale

POST/api/v2/LinearizePdf

postino URLhttps://api.pdf4me.com/api/v2/LinearizePdf

Informazioni importanti da non perdere

Il flag è async, non IsAsync

I campioni ufficiali inviano l'interruttore asincrono in minuscolo asincrono, UN JSON booleano. Una chiave con maiuscole/minuscole errate viene ignorata silenziosamente e il file di grandi dimensioni viene elaborato in modo sincrono.

Una risposta 200 è la PDF stessi

Il corpo è binario grezzo: scrivilo direttamente in un .pdf file. Anche i campioni ufficiali gestiscono un JSON-avvolto Base64 In caso di necessità, si ricorre a una strategia difensiva, ma il contratto principale riguarda i byte.

Stesso pagesordine dei byte diverso

La linearizzazione non modifica mai il contenuto. Riordina gli oggetti interni in modo che la pagina 1 e il catalogo del documento si trovino all'inizio del file, il che consente ai visualizzatori di visualizzare l'anteprima prima che il download sia completato.

HTTP impostare

Metodo: POST
URL: https://api.pdf4me.com/api/v2/LinearizePdf
Tipo di contenuto: applicazione/json
Authorization: Base <il tuo PDF4me API chiave>

Un corpo di risposta 200 è la versione linearizzata PDF come byte grezzi: salvalo direttamente. Una risposta 202 significa elaborazione asincrona: interroga il Location URL con GET circa ogni 10 secondi (i campioni ufficiali utilizzano intervalli di 10 secondi, fino a 10 tentativi) fino a 200.

Quale profilo di ottimizzazione dovrei scegliere?

Sono accettati nove profili, suddivisi in tre famiglie con obiettivi differenti.

Profilo famiglia vsobiettivo	Profili	Per cosa ottimizzano
Web	`web`, `WebMax`	Visualizzazione progressiva e rendering rapido della prima pagina nei browser; WebMax è l'ottimizzazione web più aggressiva
Stampa	`Print`, `PrintMax`, `PrintGray`	Output orientato alla stampa; PrintGray converte anche in stampa in scala di grigi
Compressione	`Compress`, `CompressMax`	Dimensioni del file ridotte al minimo; CompressMax sacrifica la potenza di elaborazione per una maggiore riduzione.
Generale	`Default`, `Max`	Le impostazioni predefinite del motore e il livello massimo di ottimizzazione generale

Per PDFs servito sui siti web, inizia con web e fare un passo avanti WebMax solo se, dopo i test, la latenza della prima pagina risulta ancora rilevante.

API campi corporei

Parametro	Necessario	Tipo	Cosa fa	Esempio
`docContent`	Required	string	Base64-encoded bytes of the source PDF.	`JVBERi0xLjcK...`
`docName`	Required	string	Source PDF filename with its .pdf extension.	`document.pdf`
`optimizeProfile`	Required	string	Optimization profile. Allowed values: web, Max, Print, Default, WebMax, PrintMax, PrintGray, Compress, CompressMax. Values are case-sensitive as listed.	`web`
`async`	Optional	boolean	Lowercase JSON boolean. true returns 202 plus a Location URL to poll, for large files. false or omitted returns the linearized PDF directly on 200.	`true`

Esempi di carichi utili

Linearizza per la visualizzazione sul web

{
 "docContent": "JVBERi0xLjcKJb...",
 "docName": "report.pdf",
 "optimizeProfile": "web"
}

File di grandi dimensioni, asincrono

{
 "docContent": "JVBERi0xLjcKJb...",
 "docName": "catalog-2026.pdf",
 "optimizeProfile": "WebMax",
 "async": true
}

Consigli per la raccolta del postino

Headers

Content-Type: application/json + Authorization: Basic <apiKey>.

Body

raw JSON with docContent, docName, optimizeProfile, and optionally async (lowercase, boolean).

Response

On 200, use "Send and Download": the body is the PDF itself, not JSON.

Async

With async true, copy the Location header from the 202 response into a GET request and poll it every ~10 seconds until 200.

esempio di riccio

curl -X POST https://api.pdf4me.com/api/v2/LinearizePdf \
 -H "Content-Type: application/json" \
 -H "Authorization: Basic YOUR_API_KEY" \
 -d '{
 "docContent": "'"$(base64 -w 0 report.pdf)"'",
 "docName": "report.pdf",
 "optimizeProfile": "web"
 }' \
 --output linearized.pdf

Che cosa significa il API ritorno?

Campo	Tipo	Cosa contiene
`200 response body`	Binary (application/pdf)	The linearized PDF as raw bytes. Save it directly. The official samples also handle a JSON-wrapped Base64 fallback, but binary is the primary contract.
`202 Location header`	URL	Async mode only: the polling URL. GET it about every 10 seconds (samples: 10 retries) until it returns 200 with the PDF bytes.
`4xx/5xx response body`	JSON or text	Error details: 400 for malformed Base64 or an unknown optimizeProfile value, 401 for a missing or invalid API key, 500 for server-side processing failures.

Esempi di codice

Esempi ufficiali e funzionanti per questo endpoint specifico, per language:

FAQ

What is a linearized PDF?+

A PDF whose internal objects are reordered so the first page and its resources sit at the front of the file. A viewer can render page 1 while the rest is still downloading, which is why linearization is also called fast web view.

Does linearization change how the PDF looks?+

No. Pages, text, and images stay identical. Only the internal object order and structure change so browsers and viewers can start rendering before the full file arrives.

Which optimizeProfile should I use for websites?+

Start with web. If load speed matters more than anything else, WebMax applies the most aggressive web optimization. The print and compress profiles target paper output and file size instead of progressive display.

Is the async flag called IsAsync?+

No. The official samples send it as lowercase async, a JSON boolean. Sending true switches the API to 202-plus-polling mode; false or omitting it returns the linearized PDF directly in the response body.

Is the response JSON with a Base64 file inside?+

Normally no: a 200 response body is the linearized PDF as raw bytes, ready to save. The official samples also defensively handle a JSON-wrapped Base64 variant, but the primary contract is binary.

How is this different from Compress PDF?+

Compress PDF exists to shrink file size. Linearize PDF exists to reorder the file for progressive display; the Compress and CompressMax profiles borrow some size reduction, but if pure size is the goal, use the dedicated Compress PDF endpoint.

Does my web server need special support?+

For the full benefit the server should support HTTP byte-range requests, which mainstream web servers and CDNs do by default. The linearized file still opens normally everywhere, even without range support.

Perché linearizzare PDFs per il web?

Uno standard PDF memorizza le informazioni della directory alla fine del file, quindi un visualizzatore deve scaricare praticamente tutto prima di visualizzare la pagina 1. Linearizzato PDF, definito come allegato normativo del ISO Specifiche 32000, sposta quella directory e la prima pagina in primo piano, consentendo l'accesso incrementale HTTP. Per un portale di documenti o CDNche trasforma un'attesa di diversi secondi senza elementi visualizzati in una prima pagina che appare mentre il resto viene caricato in streaming.