ForHosting KIT · Dokumente & PDF

PDF-Linearisierung und schnelle Webanzeige prüfen

Die PDF-Linearisierung ist eine strukturelle Anordnung, durch die ein kompatibler Betrachter die erste Seite anzeigen kann, während der Rest eines entfernten Dokuments noch heruntergeladen wird.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Diese Prüfung übernimmt das boolesche Linearisierungsmerkmal eines PDF-Analysewerkzeugs und erstellt daraus einen kompakten, berichtsfertigen Befund. Sie nennt den Status der schnellen Webanzeige, erläutert die praktische Bedeutung, grenzt die Auslieferungsoptimierung von der Dateigültigkeit ab und empfiehlt den nächsten Schritt, ohne das PDF hochzuladen oder neu zu schreiben.

Lesen Sie das Strukturmerkmal richtig

Ein PDF-Prüfprogramm kann die Linearisierung als boolesches Merkmal ausgeben, gelegentlich neben Bezeichnungen wie Schnelle Webanzeige oder Für das Web optimiert. Übernehmen Sie dieses exakte Strukturergebnis in das Feld linearized: true bedeutet, dass das erwartete Linearisierungswörterbuch und die vorgesehene Reihenfolge erkannt wurden; false besagt, dass die Datei diese Anordnung nicht ausweist. Die Prüfung verlangt bewusst das Merkmal und leitet den Status weder aus Dateiname und Dateigröße noch aus Downloadtempo oder Metadaten ab. Solche indirekten Hinweise belegen die Anordnung der Objekte im Dokument nicht. Das Ergebnis wiederholt den normalisierten booleschen Wert, liefert einen stabilen Status für automatisierte Abläufe und formuliert eine verständliche Zusammenfassung für technische Berichte. Fehlt das Merkmal in der Analyseausgabe, dürfen Sie es nicht durch false ersetzen. Eine fehlende Beobachtung bedeutet unbekannter Status; false ist dagegen ein bestimmter struktureller Befund. Deshalb meldet die Funktion einen Eingabefehler, wenn das Merkmal fehlt oder nicht boolesch ist. So gelangt keine unbelegte Aussage in ein Audit oder einen Qualitätssicherungsnachweis.

Verstehen Sie die Wirkung der schnellen Webanzeige

Ein linearisiertes PDF ordnet die für eine frühe Darstellung benötigten Informationen nahe am Dateianfang an. Außerdem enthält es Hinweise, mit denen ein unterstützender Betrachter nützliche Bytebereiche anfordern kann. Liegt die Datei auf einem Server, der Bereichsanfragen unterstützt, kann ein kompatibler Browser oder PDF-Betrachter die erste Seite möglicherweise darstellen, bevor sämtliche Bytes eingetroffen sind. Das kann bei großen Dokumenten, langsamen Verbindungen und beim Lesen weniger Anfangsseiten reaktionsschneller wirken. Der Bericht formuliert bewusst vorsichtig: Das Strukturmerkmal schafft eine Voraussetzung, garantiert aber keine Leistung. Das tatsächliche Verhalten hängt auch von HTTP-Auslieferung, Cache, Netzwerklatenz, Betrachter, Dokumentkomplexität und späteren Verarbeitungsschritten ab. Die Linearisierung komprimiert das PDF nicht, verringert nicht die Seitenzahl, bestätigt weder Barrierefreiheit noch Signaturen und beweist nicht die allgemeine Fehlerfreiheit. Ebenso kann ein kleines oder zwischengespeichertes, nicht linearisiertes PDF schnell öffnen. Der Befund beschreibt daher die Eignung für progressive Auslieferung und keine gemessene Geschwindigkeitssteigerung.

Nutzen Sie den Befund in Bericht und Arbeitsablauf

Bei einem positiven Ergebnis dokumentieren Sie, dass das PDF linearisiert ist und die schnelle Webanzeige unterstützt. Behalten Sie den Hinweis bei, dass die Auslieferungsbedingungen den wahrnehmbaren Nutzen bestimmen. Bei einem negativen Ergebnis halten Sie fest, dass die schnelle Webanzeige nicht ausgewiesen wird und für die entfernte Darstellung der ersten Seite möglicherweise ein größerer Dateianteil geladen werden muss. Bezeichnen Sie das Dokument nicht als beschädigt: Nicht linearisierte PDFs sind üblich und können vollständig gültig sein. Die Empfehlung gilt bedingt: Linearisieren Sie die Datei, wenn die progressive HTTP-Anzeige wichtig ist, und untersuchen Sie danach die neu geschriebene Ausgabe erneut. Bearbeiten, Optimieren, Signieren, Zusammenführen oder Neugenerieren kann die interne Reihenfolge verändern und eine zuvor gültige Linearisierung entfernen. Führen Sie in automatisierten Veröffentlichungen die Strukturanalyse nach dem letzten Erzeugungsschritt aus, übergeben Sie hier deren booleschen Wert und speichern Sie Status sowie Erläuterung bei den Freigabenachweisen. Stabile Felder vereinfachen Regeln: Webabläufe können true verlangen, Archiv- oder lokale Abläufe beide Werte informativ zulassen.

Anwendungsfälle

Eine Webveröffentlichungsprüfung dokumentieren

Wandeln Sie das Strukturmerkmal eines Prüfprogramms vor der Veröffentlichung eines großen PDFs in einen einheitlichen Befund um.

Ergebnisse der Qualitätssicherung vereinheitlichen

Überführen Sie true oder false in stabile Statusfelder und Berichtstext, den nachgelagerte Prüfungen speichern und vergleichen können.

Ein negatives Ergebnis sachlich erklären

Stellen Sie klar, dass fehlende Optimierung für schnelle Webanzeige die progressive Auslieferung betrifft, das PDF aber nicht automatisch ungültig macht.

Häufige Fragen

Welche Eingabe benötigt die Prüfung?

Sie benötigt das boolesche Linearisierungsmerkmal aus einer PDF-Strukturanalyse: true oder false. Ein fehlender oder unbekannter Wert wird nicht als false behandelt.

Untersucht oder überträgt diese Funktion die PDF-Datei?

Nein. Sie interpretiert ein Strukturmerkmal, das bereits in einem anderen PDF-Analyseschritt ermittelt wurde.

Öffnet ein linearisiertes PDF immer schneller?

Nein. Es ermöglicht progressive Auslieferung; das tatsächliche Erlebnis bestimmen jedoch Server, Betrachter, Verbindung, Cache, Komplexität und Dateigröße.

Ist ein nicht linearisiertes PDF beschädigt?

Nein. Fehlende Linearisierung ist ein Befund zur Auslieferungsoptimierung und kein Beleg für Beschädigung oder Ungültigkeit.

Kann eine Bearbeitung die Linearisierung entfernen?

Ja. Neuschreiben, Zusammenführen, Signieren oder Optimieren kann die Objektreihenfolge ändern; prüfen Sie deshalb das endgültige Dokument erneut.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Die Browserversion führt dieselbe deterministische Auswertung lokal aus.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/pdf/linearize-check

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/pdf/linearize-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linearized":true}'

const res = await fetch("https://api.kit.forhosting.com/pdf/linearize-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "linearized": true
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/linearize-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "linearized": true
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/linearize-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"linearized":true}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"linearized":true}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/linearize-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "linearized": true
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.linearize_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

`max_mb`	25
`max_pages`	200

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →