ForHosting KIT · Dokumente & PDF

PDF-Formularfelder in statischen Seiteninhalt umwandeln

Ada (Countess) Lovelace in einem Textfeld auf Seite 1 und ein angehaktes Kästchen auf Seite 2 werden zu festem Seiteninhalt, und der Bericht bestätigt beide. Das Formular hat danach keine aktiven Felder mehr, die jemand ändern könnte. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Überführen Sie ein ausgefülltes interaktives PDF-Formular in eine stabile Darstellung, bei der die eingegebenen Werte zum Seiteninhalt gehören. Diese Funktion übernimmt Seiteninhalte und Felddefinitionen, prüft jeden Wert und jede Position, erzeugt deterministische statische Darstellungsoperationen, entfernt die interaktive Feldsammlung und meldet genau, welche Felder reduziert wurden. Sie eignet sich für verlässliche Abläufe, nachdem ein PDF analysiert, ausgefüllt und freigegeben wurde, und gibt einen eindeutigen Fehler zurück, wenn das bereitgestellte Formular keine Felder enthält.

Was die Reduzierung an einem ausgefüllten Formular ändert

Ein ausgefülltes PDF kann fertig aussehen und dennoch bearbeitbare Steuerelemente enthalten. Textfelder, Kontrollkästchen, Auswahllisten, Optionsfelder und sichtbare Signaturwerte können von den gewöhnlichen Zeichenanweisungen einer Seite getrennt bleiben. Das ist relevant, sobald ein Dokument ausgeliefert, gedruckt oder archiviert wird: Ein Anzeigeprogramm kann das Steuerelement offenlegen oder verändern, und verschiedene Programme können seine Darstellung unterschiedlich wiedergeben.

Diese Funktion nimmt die von Ihnen übermittelten Werte und schreibt für jeden eine statische Darstellungsoperation in den Inhalt der zugehörigen Seite. Die Operation wird auf das angegebene Feldrechteck begrenzt, verwendet eine stabile Zahlenformatierung und schützt Zeichen mit besonderer Bedeutung in PDF-Zeichenketten. Nach der Verarbeitung ist die zurückgegebene Sammlung interaktiver Felder leer.

Sichtbare Werte gehören damit zum Seitenmodell und sind nicht mehr von aktiven Steuerelementen abhängig. Die Ausgabe enthält außerdem einen Bericht in Eingabereihenfolge, damit Ihr Ablauf jede Änderung präzise dokumentieren kann.

So bereiten Sie Seiten und Feldwerte richtig vor

Übermitteln Sie mindestens eine Seite mit einer eindeutigen positiven Seitennummer und ihrem bestehenden statischen Inhaltsstrom als Text. Geben Sie anschließend jedes ausgefüllte Feld mit eindeutigem Namen, Seitennummer, Feldtyp, Zeichenkettenwert und Rechteckkoordinaten in PDF-Punkten an. Unterstützt werden Textfelder, Kontrollkästchen, Optionsfelder, Auswahlfelder und Signaturen.

Werte sind Zeichenketten, weil die Reduzierung den angezeigten Wert verarbeitet: Ein markiertes Kästchen kann beispielsweise „Yes“ verwenden, während ein Auswahlfeld seine gewählte Beschriftung nutzt. Jedes Feld muss auf eine vorhandene Seite verweisen; Breite und Höhe müssen größer als null sein. Sämtliche Koordinaten und Maße müssen endliche Zahlen sein.

Die Prüfung ist bewusst streng. Doppelte Namen oder Seiten, unbekannte Typen, ungültige Geometrie, fehlende Seiten oder Werte eines falschen Typs führen zu einem klaren Eingabefehler statt zu einem unvollständigen Ergebnis. Insbesondere wird eine leere Feldliste ausdrücklich abgelehnt, damit ein wirkungsloser Vorgang nicht als Erfolg erscheint.

Den Bericht in einem zuverlässigen Dokumentenablauf nutzen

Setzen Sie diese Umwandlung nach dem Ausfüllen und der menschlichen oder automatischen Freigabe ein, jedoch vor der endgültigen Auslieferung oder Archivierung. Das Ergebnis enthält nach Nummer sortierte Seiten, deren ursprünglichen Inhalt mit angehängten Darstellungsoperationen, eine leere Feldsammlung, die Anzahl der reduzierten Felder und einen ausführlichen Bericht. Jeder Berichtseintrag bewahrt ursprünglichen Namen, Seite, Typ und Anzeigewert.

Vergleichen Sie die Anzahl mit der in Ihrem Ablauf erwarteten Feldzahl oder speichern Sie den Bericht zusammen mit dem Prüfprotokoll, um spätere Untersuchungen zu vereinfachen. Die Funktion modelliert die Formularreduzierung und analysiert keine rohen PDF-Bytes. Ein Binärsystem sollte daher zuerst Seiten und AcroForm-Felder einlesen und anschließend das zurückgegebene statische Seitenmodell in seinen PDF-Container serialisieren.

Anwendungsfälle

Einen genehmigten Antrag abschließen

Übernehmen Sie die Werte nach der Prüfung in den Seiteninhalt und bewahren Sie den Feldbericht bei den Antragsunterlagen auf.

Formulare vor dem Drucken stabilisieren

Beseitigen Sie die Abhängigkeit von interaktiven Elementen und stellen Sie Werte mit deterministischen Zeichenoperationen dar.

Häufige Fragen

Was geschieht, wenn das Formular keine Felder enthält?

Die Anfrage endet mit einem Eingabefehler, der auf das Fehlen von PDF-Formularfeldern hinweist. Ein leeres Formular gilt nie als reduziert.

Welche Feldtypen werden unterstützt?

Unterstützt werden Text, Kontrollkästchen, Optionsfelder, Auswahlfelder und Signaturen. Die angegebene Zeichenkette gilt als Anzeigewert.

Analysiert diese Funktion eine binäre PDF-Datei?

Nein. Sie wandelt bereits analysierte Inhalte und Werte deterministisch um. Ein Binärablauf analysiert vorher und serialisiert danach.

Zerstören Klammern oder andere Sonderzeichen in einem Namen die Seite?

Nein. Zeichen, die in einem PDF eine besondere Bedeutung haben, werden beim Schreiben geschützt, sodass ein Name wie Ada (Countess) Lovelace genau so erscheint, wie er eingetragen wurde. Jeder Wert wird zudem auf das Rechteck seines Feldes begrenzt.

Kann ich nachvollziehen, welche Felder fixiert wurden?

Ja. Sie erhalten einen Bericht Feld für Feld in der Reihenfolge Ihrer Eingabe, mit Name, Seite, Art und Wert. So lässt sich genau festhalten, was sich geändert hat, statt anzunehmen, dass jedes Feld erfasst wurde.

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/flatten-form

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/flatten-form \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages":[{"number":1,"content":"q 1 0 0 1 0 0 cm Q"}],"fields":[{"name":"full_name","page":1,"type":"text","value":"Ada Lovelace","x":72,"y":680,"width":220,"height":18}]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/flatten-form", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pages": [
      {
        "number": 1,
        "content": "q 1 0 0 1 0 0 cm Q"
      }
    ],
    "fields": [
      {
        "name": "full_name",
        "page": 1,
        "type": "text",
        "value": "Ada Lovelace",
        "x": 72,
        "y": 680,
        "width": 220,
        "height": 18
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/flatten-form",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pages": [
        {
            "number": 1,
            "content": "q 1 0 0 1 0 0 cm Q"
        }
    ],
    "fields": [
        {
            "name": "full_name",
            "page": 1,
            "type": "text",
            "value": "Ada Lovelace",
            "x": 72,
            "y": 680,
            "width": 220,
            "height": 18
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/flatten-form", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pages":[{"number":1,"content":"q 1 0 0 1 0 0 cm Q"}],"fields":[{"name":"full_name","page":1,"type":"text","value":"Ada Lovelace","x":72,"y":680,"width":220,"height":18}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pages":[{"number":1,"content":"q 1 0 0 1 0 0 cm Q"}],"fields":[{"name":"full_name","page":1,"type":"text","value":"Ada Lovelace","x":72,"y":680,"width":220,"height":18}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/flatten-form", 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": [
    {
      "number": 1,
      "content": "q 1 0 0 1 0 0 cm Q"
    }
  ],
  "fields": [
    {
      "name": "full_name",
      "page": 1,
      "type": "text",
      "value": "Ada Lovelace",
      "x": 72,
      "y": 680,
      "width": 220,
      "height": 18
    }
  ]
}

Beispiel-Antwort

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

Technische Hinweise

Den Bericht in einem zuverlässigen Dokumentenablauf nutzen

Da der Algorithmus weder Netzwerk noch Zufallsentscheidungen, Uhrzeit oder gemeinsam veränderlichen Zustand verwendet, erzeugt dieselbe Eingabe immer dasselbe JSON. Diese Deterministik unterstützt Referenztests, Inhalts-Hashes, Wiederholungen und reproduzierbare Builds.

Integrationsbeispiele

Einen automatisierten Dokumentenablauf prüfen

Vergleichen Sie flattened_count und flattened_fields vor Serialisierung, Auslieferung oder Archivierung mit dem erwarteten Schema.

Technische Fragen

Was kostet diese Funktion?

Jede API-Anfrage kostet $0.002. Die Browser-Implementierung verwendet dieselbe deterministische Umwandlung.

Nennt das Ergebnis die reduzierten Felder?

Ja. flattened_fields enthält Name, Seite, Typ und Wert jedes Feldes; flattened_count gibt die Gesamtzahl an.

Vollständige KIT-Dokumentation lesen →

PDF-Formularfelder in statischen Seiteninhalt umwandeln

Im Browser ausführen – kostenlos

Was die Reduzierung an einem ausgefüllten Formular ändert

So bereiten Sie Seiten und Feldwerte richtig vor

Den Bericht in einem zuverlässigen Dokumentenablauf nutzen

Anwendungsfälle

Einen genehmigten Antrag abschließen

Formulare vor dem Drucken stabilisieren

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Limits

Fehler

Technische Hinweise

Den Bericht in einem zuverlässigen Dokumentenablauf nutzen

Integrationsbeispiele

Einen automatisierten Dokumentenablauf prüfen

Technische Fragen

danke