Doğrusallaştırmak PDF

PDF4me Doğrusallaştırmak PDF bir REST yeniden yapılandıran bir uç nokta PDF Hızlı web görüntüleme için. POST Dosya şu şekildedir: Base64 ile /api/v2/LinearizePdf ile bir optimizeProfileve API İç nesnelerinin sırasını yeniden düzenleyerek, geri kalan sayfalar indirilirken ilk sayfanın oluşturulmasını sağlar, ardından doğrusal hale getirilmiş veriyi döndürür. PDF Ham baytlar olarak. Dokuz profil web, baskı ve sıkıştırmayı kapsar.

Bu uç noktanın işlevi

Bir süre alır PDF ve aynı belgeyi aşamalı yükleme için yeniden düzenlenmiş şekilde döndürür: dizin bilgileri ve 1. sayfa kaynakları dosyanın başına taşınır, böylece bir tarayıcı veya yerleşik görüntüleyici, tüm indirme işleminin tamamlanmasını beklemek yerine ilk sayfayı neredeyse anında gösterir. pages Kendileri dokunulmaz kalır. Belge portalları, CDN'ler ve her türlü uygulama için idealdir. PDF servis edildi HTTP.

İlgili Blog Yazıları

Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.

Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.

Blogu ziyaret edin →

Kimliğinizi Doğrulama API Rica etmek

Her PDF4me REST Çağrınızda mutlaka sizin de bulunmanız gerekiyor. API anahtara Authorization Başlıkta Temel kimlik doğrulama (Basic auth) belirtilmiştir. Anahtarınızı geliştirici kontrol panelinden alın veya değiştirin.

Get your API Key

Uç nokta

POST/api/v2/DoğrusalPdf

Postacı URLhttps://api.pdf4me.com/api/v2/LinearizePdf

Kaçırmamanız Gereken Önemli Bilgiler

Bayrak asenkron, IsAsync değil.

Resmi örnekler, eşzamansız anahtarı küçük harf olarak gönderiyor. asenkron, A JSON Mantıksal değer. Büyük/küçük harf yanlış yazılmış bir anahtar sessizce göz ardı edilir ve büyük dosyanız eş zamanlı olarak işlenir.

200 yanıtı şudur: PDF kendisi

Gövde ham ikili veridir: doğrudan bir dosyaya yazın.pdf Dosya. Resmi örnekler ayrıca bir dosyayı da ele alıyor. JSON-sarılmış Base64 Savunma açısından yedek planımız var, ancak asıl sözleşmemiz baytlarla ilgili.

Aynı pagesfarklı bayt sırası

Doğrusallaştırma hiçbir zaman içeriği düzenlemez. İç nesnelerin sırasını değiştirerek 1. sayfayı ve belge kataloğunu dosyanın başına getirir; bu da görüntüleyicilerin indirme işlemi tamamlanmadan önce içeriği görüntülemesine olanak tanır.

HTTP kurmak

Yöntem: POST
URL: https://api.pdf4me.com/api/v2/LinearizePdf
İçerik Türü: uygulama/json
Authorization: Temel <sizin PDF4me API anahtar>

200 yanıt gövdesi doğrusallaştırılmıştır. PDF Ham baytlar olarak: doğrudan kaydedin. 202 yanıtı, eşzamansız işlemeyi ifade eder: yoklama yapın. Location URL ile GET 200'e kadar yaklaşık her 10 saniyede bir (resmi örnekler 10 saniyelik aralıklar ve en fazla 10 deneme kullanır).

Hangi optimizeProfile'ı seçmeliyim?

Dokuz profil kabul edildi. Bunlar, farklı hedeflere sahip üç gruba ayrılıyor.

Profil, aile ve hedef	Profiller	Ne için optimize ediyorlar?
Web	`web`, `WebMax`	Tarayıcılarda aşamalı görüntüleme ve hızlı ilk sayfa oluşturma; WebMax en agresif web optimizasyonudur.
Yazdır	`Print`, `PrintMax`, `PrintGray`	Yazdırmaya yönelik çıktı; PrintGray ayrıca gri tonlamalı yazdırmaya da dönüştürme yapar.
Sıkıştırma	`Compress`, `CompressMax`	En küçük dosya boyutu; CompressMax daha fazla küçültme için daha fazla işlem gücü harcar.
Genel	`Default`, `Max`	Motor varsayılan ayarları ve maksimum genel optimizasyon seviyesi

İçin PDFs Web sitelerinde sunulanlar, şunlarla başlar: web ve bir üst seviyeye çıkmak WebMax İlk sayfa gecikmesi testlerden sonra hala önemliyse, o zaman geçerlidir.

API vücut alanları

Parametre	Gerekli	Tip	Ne işe yarar?	Örnek
`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`

Örnek yükler

Web'de görüntüleme için doğrusallaştırın

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

Büyük dosya, eşzamansız

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

Postacı tahsilat ipuçları

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.

curl örneği

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

Ne anlama geliyor? API geri dönmek?

Alan	Tip	İçeriğinde neler var?
`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.

Kod örnekleri

Bu uç nokta için resmi, çalıştırılabilir örnekler, language:

SSS

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.

Neden doğrusallaştırıyoruz? PDFs İnternet için mi?

Bir standart PDF Dizin bilgilerini dosyanın sonunda saklar, bu nedenle bir görüntüleyicinin 1. sayfayı oluşturmadan önce esasen her şeyi indirmesi gerekir. Doğrusallaştırılmış PDFnormatif bir ek olarak tanımlanmıştır ISO 32000 spesifikasyonuBu komut, söz konusu dizini ve ilk sayfayı öne taşıyarak artımlı erişimi mümkün kılar. HTTPBelge portalı için veya CDNBu, birkaç saniyelik boş bekleme süresini, geri kalan içerik akmaya devam ederken görünen ilk sayfaya dönüştürür.