Linealizar PDF

PDF4me Linealizar PDF es un REST punto final que reestructura un PDF para una visualización web rápida. POST el archivo como Base64 a /api/v2/LinearizePdf con un optimizeProfiley el API reordena sus objetos internos para que la primera página se renderice mientras el resto aún se está descargando, luego devuelve el linealizado PDF como bytes sin procesar. Nueve perfiles cubren web, impresión y compresión.

Lo que hace este punto final

Toma un PDF y devuelve el mismo documento reorganizado para la carga progresiva: la información del directorio y los recursos de la página 1 se mueven al principio del archivo, de modo que un navegador o un visor integrado muestra la primera página casi inmediatamente en lugar de esperar a que se descargue todo. pages ellos mismos permanecen intactos. Ideal para portales de documentos, CDN y cualquier PDF servido durante HTTP.

Entradas de blog relacionadas

Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.

Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.

Visita el blog →

Autenticando su API Pedido

Cada PDF4me REST La llamada debe incluir su API clave en el Authorization Encabezado como autenticación básica. Obtenga o cambie su clave desde el panel de desarrollador.

Get your API Key

Punto final

POST/api/v2/LinearizarPDF

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

Datos importantes que no debes perderte

La bandera es asíncrona, no IsAsync.

Las muestras oficiales envían el interruptor asíncrono en minúsculas. asíncrono, a JSON booleano. Una clave con mayúsculas y minúsculas incorrectas se ignora silenciosamente y el archivo grande se procesa de forma síncrona.

Una respuesta de 200 es la PDF La misma

El cuerpo es binario puro: escríbalo directamente a un .pdf archivo. Las muestras oficiales también manejan un JSON-envuelto Base64 Se recurre a medidas defensivas de respaldo, pero el contrato principal es de bytes.

Mismo pages, diferente orden de bytes

La linealización nunca modifica el contenido. Reordena los objetos internos de manera que la página 1 y el catálogo del documento se sitúen al principio del archivo, lo que permite a los usuarios visualizarlo antes de que finalice la descarga.

HTTP configuración

Método: POST
URL: https://api.pdf4me.com/api/v2/LinearizePdf
Tipo de contenido: aplicación/json
Authorization: Básico <tu PDF4me API clave>

Un cuerpo de respuesta de 200 es el linealizado. PDF como bytes sin procesar: guárdelo directamente. Una respuesta 202 significa procesamiento asíncrono: sondee el Location URL con GET aproximadamente cada 10 segundos (las muestras oficiales usan intervalos de 10 segundos, hasta 10 reintentos) hasta 200.

¿Qué perfil de optimización debo elegir?

Se aceptan nueve perfiles. Estos se dividen en tres familias con objetivos diferentes.

Perfil familiar vs. objetivo	Perfiles	Para qué se optimizan
Web	`web`, `WebMax`	Visualización progresiva y renderizado rápido de la primera página en navegadores; WebMax es la optimización web más agresiva.
Imprimir	`Print`, `PrintMax`, `PrintGray`	Salida orientada a la impresión; PrintGray también convierte a impresión en escala de grises.
Compresión	`Compress`, `CompressMax`	Tamaño de archivo más pequeño; CompressMax sacrifica más procesamiento por una mayor reducción.
General	`Default`, `Max`	El motor tiene valores predeterminados y el nivel máximo de optimización general.

Para PDFs servido en sitios web, comience con web y dar un paso al frente WebMax Solo si la latencia de la primera página sigue siendo importante después de las pruebas.

API campos corporales

Parámetro	Requerido	Tipo	Lo que hace	Ejemplo
`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`

Cargas útiles de ejemplo

Linealizar para visualización web

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

Archivo grande, asíncrono

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

Consejos para el cobro de carteros

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.

Ejemplo de curl

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

¿Qué significa el API ¿devolver?

Campo	Tipo	Lo que 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.

Ejemplos de código

Muestras oficiales y ejecutables para este punto final exacto, por language:

Preguntas frecuentes

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.

¿Por qué linealizar? PDFs ¿Para la web?

Un estándar PDF Almacena la información de su directorio al final del archivo, por lo que un visor debe descargar prácticamente todo antes de renderizar la página 1. Linealizado PDF, definido como un anexo normativo de la ISO Especificación 32000, mueve ese directorio y la primera página al frente, lo que permite el acceso incremental a través de HTTP. Para un portal de documentos o CDN, que convierte una espera en blanco de varios segundos en una primera página que aparece mientras el resto se va cargando.