ForHosting KIT · Dokumente & PDF

Zwei PDFs überlagern und jede kombinierte Seite beschreiben

Zwei PDFs überlagern beschreibt den Inhalt einer seitenweisen Stapelung, bevor Sie das fertige Dokument erstellen oder prüfen.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Geben Sie für jede Seite des Basis-PDFs und des darüberliegenden PDFs eine geordnete Beschreibung an. Das Ergebnis behält die Zuordnung bei, nennt die Reihenfolge der Ebenen und liefert für jede kombinierte Seite eine knappe Beschreibung. Dies eignet sich besonders zur Prüfung von Stempelvorlagen, Briefpapier, Freigabevermerken und anderen wiederkehrenden Grafiken. Unterschiedliche Seitenzahlen werden abgelehnt, da dann keine eindeutige Zuordnung entsprechender Seiten möglich ist.

Beschreiben Sie beide PDFs in Seitenreihenfolge

Beginnen Sie mit zwei Arrays aus extrahiertem Text oder knappen visuellen Beschreibungen, jeweils eine Zeichenfolge pro PDF-Seite. Das Array pages_base steht für das unten liegende Dokument, pages_overlay für das darüber platzierte Dokument. Behalten Sie in beiden Arrays die ursprüngliche Seitenreihenfolge bei: Die erste Basisbeschreibung wird der ersten Überlagerungsbeschreibung zugeordnet, die zweite der zweiten und so weiter. Eine Beschreibung kann Text, Logos, Stempel, Rahmen, Formularfelder oder jedes andere für Ihre Prüfung relevante Merkmal nennen. Verwenden Sie für eine tatsächlich leere Seite eine leere Zeichenfolge. Entfernen Sie diesen Eintrag nicht, da sich sonst alle nachfolgenden Zuordnungen verschieben. Diese Fähigkeit beschreibt eine geplante oder extrahierte Stapelung, verändert jedoch keine PDF-Bytes. Daher eignet sie sich für Ablaufkontrollen, Audit-Protokolle und lesbare Vorschauen, wenn ein anderes System den Seiteninhalt bereits extrahiert hat oder den Aufbau der Vorlage kennt. Beide Felder müssen nicht leere Arrays sein, jedes Element muss eine Zeichenfolge enthalten und die Eingabegrenze verhindert versehentlich unhandliche Aufträge.

Verstehen Sie das Ergebnis der Überlagerung

Für jede Seitennummer bezeichnet die Antwort die untere Basisebene und die obere Überlagerungsebene. Die ausdrücklich angegebene Reihenfolge ist wichtig: Ein Stempel, Briefkopf oder Hinweis im oberen PDF wird gedanklich nach dem darunterliegenden Dokument gezeichnet und kann in einer gerenderten Datei Teile davon verdecken. Da reine Beschreibungen keine Koordinaten, Farben, Transparenzwerte, Schriftarten oder genauen Objektgrenzen enthalten, beansprucht das Werkzeug keine pixelgenaue Kollisionserkennung. Stattdessen liefert es eine deterministische Darstellung, welche beschriebenen Inhalte zu jeder zusammengesetzten Seite beitragen. Leere Seiten werden gesondert behandelt. Ist die Überlagerungsseite leer, meldet die Antwort, dass die Basis unverdeckt bleibt; ist die Basis leer, trägt nur die obere Ebene beschriebenen Inhalt bei; sind beide leer, wird dieser Zustand direkt festgehalten. Leerraum wird vereinheitlicht, damit aus Extraktionswerkzeugen kopierte Beschreibungen lesbar und stabil bleiben. Gleiche Eingaben erzeugen stets dieselbe Seitenfolge und Formulierung. Das macht die Ergebnisse für automatisierte Tests und Freigabeprotokolle zuverlässig.

Erkennen Sie Seitenzahlfehler vor der Produktion

Eine Seitenüberlagerung ist nur sinnvoll, wenn jede Basisseite genau eine entsprechende Überlagerungsseite besitzt. Deshalb vergleicht die Fähigkeit zuerst die Längen beider Arrays und gibt bei Abweichungen einen Fehler wegen ungültiger Eingabe zurück. Dieses strikte Verhalten erkennt einen häufigen Fehler in der Dokumentenproduktion: Eine zweiseitige Stempelvorlage wird auf einen dreiseitigen Vertrag angewendet oder ein Deckblatt wurde nur in eine der beiden Dateien eingefügt. Korrigieren Sie die Quelldokumente oder ergänzen Sie bewusst die Beschreibung einer leeren Seite, damit die Strukturen übereinstimmen, und führen Sie die Anfrage erneut aus. Die Antwort enthält die geprüfte Seitenzahl, die allgemeine Reihenfolge von unten nach oben und einen nummerierten Datensatz für jedes Paar. So können Sie das Ergebnis mit einem Arbeitsauftrag abgleichen oder in eine Prüfoberfläche übernehmen. Die Automatisierung über die API kostet $0.002 pro Anfrage. Da die Verarbeitung lokal, deterministisch und ohne Netzwerk oder Modelle erfolgt, gehen vertrauliche Seitenbeschreibungen nicht an externe Analysedienste und die Formulierung bleibt bei identischen Ausführungen gleich.

Anwendungsfälle

Freigabestempel prüfen

Bestätigen Sie, dass jede Vertragsseite der vorgesehenen Beschreibung des Freigabe- oder Prüfstempels zugeordnet ist.

Briefpapiervorlagen kontrollieren

Beschreiben Sie, wie seitenspezifische Briefköpfe, Fußzeilen oder Rahmen über vorhandenen Inhalten liegen.

Dokumentmontage validieren

Erkennen Sie eine fehlende oder zusätzliche Vorlagenseite, bevor ein nachgelagerter Renderer die Produktions-PDFs kombiniert.

Häufige Fragen

Erstellt dieses Werkzeug ein neues PDF?

Nein. Es liefert eine strukturierte Beschreibung der seitenweisen Stapelung und verändert oder rendert keine PDF-Bytes.

Welches PDF liegt oben?

pages_overlay ist die obere Ebene und pages_base die untere Ebene.

Was geschieht bei unterschiedlichen Seitenzahlen?

Die Anfrage schlägt mit einem Fehler wegen ungültiger Eingabe fehl, der beide Seitenzahlen nennt.

Wie stelle ich eine leere Seite dar?

Behalten Sie ihre Position im Array bei und verwenden Sie eine leere Zeichenfolge, damit spätere Seiten richtig zugeordnet bleiben.

Kann das Werkzeug erkennen, ob ein Stempel bestimmte Wörter verdeckt?

Nein. Textbeschreibungen enthalten keine Geometrie oder Transparenz; das Ergebnis beschreibt Ebenen, nicht die pixelgenaue Verdeckung.

Was kostet die Nutzung?

Jede API-Anfrage kostet $0.002.

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/overlay-two-files

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/overlay-two-files \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages_base":["Invoice 1042: customer, line items, and total due","Payment terms and bank details"],"pages_overlay":["APPROVED stamp centered across the page","APPROVED stamp centered across the page"]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/overlay-two-files", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pages_base": [
      "Invoice 1042: customer, line items, and total due",
      "Payment terms and bank details"
    ],
    "pages_overlay": [
      "APPROVED stamp centered across the page",
      "APPROVED stamp centered across the page"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/overlay-two-files",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pages_base": [
        "Invoice 1042: customer, line items, and total due",
        "Payment terms and bank details"
    ],
    "pages_overlay": [
        "APPROVED stamp centered across the page",
        "APPROVED stamp centered across the page"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/overlay-two-files", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pages_base":["Invoice 1042: customer, line items, and total due","Payment terms and bank details"],"pages_overlay":["APPROVED stamp centered across the page","APPROVED stamp centered across the page"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pages_base":["Invoice 1042: customer, line items, and total due","Payment terms and bank details"],"pages_overlay":["APPROVED stamp centered across the page","APPROVED stamp centered across the page"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/overlay-two-files", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "pages_base": [
    "Invoice 1042: customer, line items, and total due",
    "Payment terms and bank details"
  ],
  "pages_overlay": [
    "APPROVED stamp centered across the page",
    "APPROVED stamp centered across the page"
  ]
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.overlay_two_files",
  "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 →