Linearizar PDF

PDF4me Linearizar PDF é um REST ponto final que reestrutura um PDF Para visualização rápida na web. POST o arquivo como Base64 para /api/v2/LinearizePdf com um optimizeProfilee o API Reordena seus objetos internos para que a primeira página seja renderizada enquanto o restante ainda está sendo baixado e, em seguida, retorna a versão linearizada. PDF como bytes brutos. Nove perfis abrangem web, impressão e compressão.

O que este endpoint faz

Leva um PDF e retorna o mesmo documento reorganizado para carregamento progressivo: as informações do diretório e os recursos da página 1 são movidos para o início do arquivo, de modo que um navegador ou visualizador incorporado exibe a primeira página quase imediatamente, em vez de esperar pelo download completo. pages eles próprios permanecem intactos. Ideal para portais de documentos, CDNs e qualquer outra aplicação. PDF servido sobre HTTP.

Autenticando seu API Solicitar

Todo PDF4me REST A chamada deve incluir o seu API chave no Authorization Defina o cabeçalho como autenticação básica. Obtenha ou altere sua chave no painel do desenvolvedor.

Get your API Key

Ponto final

POST/api/v2/LinearizePdf

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

Fatos importantes que você não deve perder

A flag é assíncrona, não IsAsync.

Os exemplos oficiais enviam a chave assíncrona em letras minúsculas. assíncrono, um JSON booleano. Uma chave com maiúsculas e minúsculas incorretas é ignorada silenciosamente e seu arquivo grande é processado de forma síncrona.

Uma resposta de 200 é a PDF em si

O corpo é binário bruto: escreva-o diretamente em um .pdf arquivo. Os exemplos oficiais também lidam com um JSON-envolto Base64 Como medida de segurança, o contrato principal é em bytes.

Mesmo pages, ordem de bytes diferente

A linearização nunca edita o conteúdo. Ela reordena os objetos internos para que a página 1 e o catálogo do documento fiquem no início do arquivo, o que permite que os visualizadores o visualizem antes que o download seja concluído.

HTTP configurar

Método: POST
URL: https://api.pdf4me.com/api/v2/LinearizePdf
Tipo de conteúdo: aplicativo/json
Authorization: Básico <seu PDF4me API chave>

Um corpo de resposta 200 é o corpo linearizado. PDF como bytes brutos: salve diretamente. Uma resposta 202 significa processamento assíncrono: consulte o Location URL com GET aproximadamente a cada 10 segundos (as amostras oficiais usam intervalos de 10 segundos, até 10 tentativas) até 200.

Qual optimizeProfile devo escolher?

Nove perfis são aceitos. Eles se dividem em três famílias com objetivos diferentes.

Perfil familiar versus objetivo	Perfis	O que eles otimizam para
Web	`web`, `WebMax`	Exibição progressiva e renderização rápida da primeira página nos navegadores; WebMax é a otimização web mais agressiva.
Imprimir	`Print`, `PrintMax`, `PrintGray`	Saída orientada para impressão; PrintGray também converte para impressão em tons de cinza.
Compressão	`Compress`, `CompressMax`	Tamanho de arquivo menor; o CompressMax troca mais processamento por mais redução.
Em geral	`Default`, `Max`	As configurações padrão do mecanismo e o nível máximo de otimização geral.

Para PDFs servido em sites, comece com web e dar um passo à frente para WebMax Somente se a latência da primeira página ainda for relevante após os testes.

API campos corporais

Parâmetro	Obrigatório	Tipo	O que faz	Exemplo
`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`

Exemplos de cargas úteis

Linearizar para visualização na web

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

Arquivo grande, assíncrono

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

Dicas de coleta do carteiro

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.

exemplo 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

O que significa o API retornar?

Campo	Tipo	O que contém
`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.

Exemplos de código

Exemplos oficiais e executáveis para este endpoint específico, por language:

Perguntas frequentes

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 que linearizar? PDFs para a web?

Um padrão PDF O arquivo armazena suas informações de diretório no final, portanto, um visualizador precisa baixar praticamente tudo antes de renderizar a página 1. Linearizado PDF, definida como um anexo normativo do ISO Especificação 32000, move esse diretório e a primeira página para o início, permitindo acesso incremental sobre HTTPPara um portal de documentos ou CDN, que transforma uma espera em branco de vários segundos em uma primeira página que aparece enquanto o restante é carregado.