ForHosting KIT · Dokumente & PDF

Leere Seite an beliebiger Stelle in ein PDF einfügen

Fügen Sie eine leere Seite in ein vorhandenes PDF ein, ohne das Dokument von Hand neu aufzubauen.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Übergeben Sie das PDF und eine ab 1 gezählte Position; das Werkzeug setzt dort eine saubere Seite mit denselben Abmessungen wie die Seite an dieser Stelle ein. Für das Dokumentende wählen Sie die Position direkt nach der aktuellen letzten Seite. Der Vorgang ist deterministisch, erhält die ursprüngliche Reihenfolge und weist ungültige Positionen eindeutig zurück.

Wählen Sie die genaue Einfügeposition

Die Zählung beginnt bei 1, weil die Position angibt, wo die neue Seite im fertigen Dokument für Leserinnen und Leser erscheint. Position 1 fügt ein leeres Blatt vor der derzeit ersten Seite ein. Position 2 platziert es zwischen der ersten und zweiten Seite. Bei einem Dokument mit fünf Seiten hängt Position 6 ein leeres Blatt nach Seite fünf an. Nur diese Positionen sind gültig: Der kleinste Wert ist 1, der größte entspricht der vorhandenen Seitenzahl plus eins. Diese klare Regel verhindert, dass eine mehrdeutige Anforderung unbemerkt ein Dokument mit einer falsch platzierten Seite erzeugt. Ist die Position null, negativ, gebrochen oder größer als die Anhängeposition, liefert die Anfrage einen Eingabefehler und lässt die Quelle unverändert. Zählen Sie vor einer Automatisierung die Seiten und berechnen Sie die Position anhand des tatsächlich übermittelten Dokuments. Das Ergebnis nennt die Einfügeposition und die neue Gesamtzahl, sodass Sie die Änderung prüfen können.

So erhält die leere Seite ihre Größe

Die eingefügte Seite verwendet die effektive MediaBox der Seite an der gewünschten Position. Vor einer hochformatigen Letter-Seite entsteht daher ein leeres Blatt im gleichen Hochformat; vor einer Seite im Querformat oder Sonderformat bleiben deren Abmessungen erhalten. Beim Anhängen gibt es keine folgende Seite als Vorlage, weshalb das neue Blatt die Größe der vorhandenen letzten Seite übernimmt. Das ist besonders praktisch bei PDFs mit gemischten Formaten, etwa gescannten Akten, Präsentationsunterlagen, Bauplänen und zusammengeführten Berichten. Das Blatt ist absichtlich leer: Es enthält keinen Inhaltsstrom, keine Anmerkungen, Formularfelder oder kopierten Markierungen. Nur die Geometrie wird übernommen. Die Antwort enthält außerdem die berechnete Breite und Höhe in PDF-Punkten, damit Sie die gewählten Maße bestätigen können. Die ursprünglichen Seiten behalten ihre Reihenfolge und ihren Inhalt.

Bereiten Sie eine kompatible Eingabe vor und prüfen Sie das Ergebnis

Übergeben Sie ein klassisches PDF als einfachen PDF-Text oder als Base64-PDF-Daten-URI. Die aktuelle Beta-Version weist Dokumente mit Cross-Reference-Streams bewusst zurück, statt Strukturen zu erraten, die nicht sicher rekonstruiert werden können. Der Parser liest Katalog und Seitenbaum, verfolgt verschachtelte Knoten, löst geerbte MediaBoxen auf, setzt die neue Referenz beim richtigen Elternknoten ein, aktualisiert alle betroffenen Seitenzahlen und erstellt eine gültige klassische Querverweistabelle. Netzwerk, Uhrzeit, Zufallswerte, Speicher oder Modelle werden nicht verwendet. Prüfen Sie anschließend die zurückgegebene Seitenzahl, Position, Breite und Höhe und speichern oder übertragen Sie dann das PDF. Testen Sie bei Automatisierungen zuerst repräsentative Dateien. Wird ein Cross-Reference-Stream abgelehnt, konvertieren Sie die Datei mit einem vertrauenswürdigen PDF-Werkzeug in ein klassisches PDF. Jede API-Anfrage kostet $0.002; derselbe deterministische Vorgang ist auch interaktiv im Browser nutzbar.

Anwendungsfälle

Ein Trennblatt ergänzen

Fügen Sie zwischen Abschnitten eines kombinierten Berichts eine saubere Seite ein, um Ausdrucke zu trennen oder zu beschriften.

Duplex-Ausrichtung wiederherstellen

Ergänzen Sie ein leeres Blatt, damit ein Kapitel oder Formular beim beidseitigen Druck auf der vorgesehenen Vorderseite beginnt.

Platz für Unterschriften oder Notizen schaffen

Setzen Sie neben Begleitmaterial ein gleich großes leeres Blatt ein, ohne das ursprüngliche PDF neu zu erstellen oder zu skalieren.

Häufige Fragen

Welche Positionen sind gültig?

Verwenden Sie eine ganze Zahl von 1 bis zur aktuellen Seitenzahl plus eins. Der letzte Wert hängt das Blatt an.

Welche Seitengröße wird verwendet?

Das leere Blatt übernimmt die effektive MediaBox der Seite an der Einfügeposition oder beim Anhängen die der letzten Seite.

Enthält die neue Seite irgendwelche Elemente?

Nein. Sie besitzt die gewählten Maße, aber keine Inhalte, Anmerkungen, Formularfelder oder kopierten Grafiken.

Was geschieht bei einer Position außerhalb des Bereichs?

Die Anfrage liefert einen Eingabefehler und erzeugt kein geändertes PDF.

Was kostet eine API-Anfrage?

Jede 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/insert-blank-page

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/insert-blank-page \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"https://ejemplo.com/documento.pdf","position":2}'

const res = await fetch("https://api.kit.forhosting.com/pdf/insert-blank-page", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf",
    "position": 2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/insert-blank-page",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf",
    "position": 2
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf","position":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/insert-blank-page", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "pdf": "https://ejemplo.com/documento.pdf",
  "position": 2
}

Beispiel-Antwort

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