ForHosting KIT · Dokumente & PDF

Pflichtfelder und Werte in PDF-Formularen validieren

Vor dem Ausfüllen werden der Name Ada Lovelace, das Geburtsdatum 1815-12-10 und die Wahl E-Mail gegen vier Feldregeln geprüft, und das unbeantwortete Newsletter-Feld wird als optional aufgeführt. Ein Datum wie 2025-02-29 wird abgelehnt. 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

Prüfen Sie Daten für ein PDF-Formular, bevor das Dokument ausgefüllt wird. Übergeben Sie die Felddefinitionen und ein Werteobjekt. Diese Funktion kontrolliert Pflichtfelder, exakte Datentypen, echte Kalenderdaten, zulässige Optionen, doppelte Definitionen und unerwartete Schlüssel. Wenn alles übereinstimmt, erhalten Sie einen bereinigten Satz validierter Werte.

Definieren Sie den Formularvertrag eindeutig

Beschreiben Sie zunächst jedes PDF-Formularfeld durch einen eindeutigen Namen, einen unterstützten Typ und eine optionale Pflichtfeldangabe. Verfügbar sind Text, endliche Zahlen, Ganzzahlen, boolesche Werte, ISO-Kalenderdaten, Einfachauswahlen und Mehrfachauswahlen. Auswahlfelder benötigen zusätzlich eine Optionsliste, damit die Prüfung einen zulässigen Eintrag von einer beliebigen Zeichenfolge unterscheiden kann.

Die Definitionen bilden den Vertrag für das Werteobjekt: Jeder übergebene Wert muss einer Definition entsprechen. Doppelte Feldnamen werden abgelehnt, weil sie die Prüfung mehrdeutig machen würden. Verwenden Sie einschließlich der Groß- und Kleinschreibung genau jene Feldnamen, die der anschließende Schritt zum Ausfüllen des PDF erwartet.

Diese Funktion untersucht keine PDF-Datei und errät keine darin enthaltenen Felder. Wenn Felderkennung und Werteprüfung getrennt bleiben, lassen sich beide Schritte leichter testen und derselbe Vertrag kann für viele Datensätze wiederverwendet werden. Wird die Pflichtfeldangabe weggelassen, gilt false.

Ein ausdrücklich erforderliches Feld muss dagegen einen sinnvollen Wert enthalten. Bei Textfeldern wird eine ausschließlich aus Leerzeichen bestehende Eingabe als fehlend behandelt.

Verstehen Sie die strenge Werteprüfung

Werte werden ohne automatische Typumwandlung geprüft. Ein boolescher Wert muss true oder false sein, nicht "yes", 1 oder 0. Datumsangaben verwenden das eindeutige Format YYYY-MM-DD und müssen einen tatsächlich existierenden Kalendertag bezeichnen; ein Eintrag wie 2025-02-29 wird deshalb abgelehnt.

Bei einer Einfachauswahl muss der Wert einschließlich der Groß- und Kleinschreibung exakt einer definierten Option entsprechen. Eine Mehrfachauswahl muss ein array aus eindeutigen zulässigen Zeichenfolgen sein; unbekannte oder doppelte Einträge führen zu einem Fehler. Diese Strenge deckt Zuordnungsfehler auf, bevor daraus unauffällig falsche Dokumente entstehen.

Optionale Felder dürfen fehlen, null sein oder eine leere Zeichenfolge enthalten. Bei Pflichtfeldern lösen dieselben leeren Darstellungen einen Fehler aus. Die Verarbeitung endet beim ersten Problem und liefert einen gezielten Hinweis, den Ihr Formular oder Ablauf anzeigen kann.

Prüfen Sie die Daten vor der PDF-Erzeugung

Setzen Sie diese Funktion unmittelbar nach der Zuordnung Ihrer Anwendungsdaten zu den PDF-Feldnamen und vor dem Werkzeug ein, das tatsächlich in das Dokument schreibt. Eine erfolgreiche Antwort enthält valid true, die Anzahl der geprüften Definitionen, die akzeptierten Werte und die nicht bereitgestellten optionalen Felder. Unbekannte Schlüssel werden zurückgewiesen, weil ein falsch geschriebener Feldname beim späteren Ausfüllen sonst unbemerkt verschwinden könnte.

Besonders bei Stapelverarbeitungen ist dies wertvoll, da eine falsche Zuordnung Hunderte von Dokumenten betreffen kann. Speichern Sie die Definitionen gemeinsam mit der Version der Vorlage, prüfen Sie jeden Datensatz gegen diese Version und geben Sie nur erfolgreiche Datensätze an den Ausfüllschritt weiter. Der Algorithmus läuft lokal und nutzt weder Netzwerk noch Zufall, Modellinferenz oder gespeicherten Zustand.

Gleiche Eingaben erzeugen daher stets gleiche Ergebnisse.

Anwendungsfälle

Onboarding-Formulare vorab prüfen

Prüfen Sie Namen, Datumsangaben, boolesche Einwilligungen und Pflichtauswahlen, bevor ausgefüllte Formulare für Beschäftigte oder Kunden entstehen.

Dokumentenstapel absichern

Lehnen Sie einen fehlerhaften Datensatz ab, bevor er die PDF-Warteschlange erreicht und ein unvollständiges Dokument erzeugt.

Häufige Fragen

Verändert diese Funktion die PDF-Datei?

Nein. Sie prüft nur Felddefinitionen und Werte. Übergeben Sie die validierten Werte anschließend an eine Funktion zum Ausfüllen von PDF-Dateien.

Wie werden Datumsangaben geprüft?

Sie müssen YYYY-MM-DD verwenden und einen echten Kalendertag einschließlich korrekter Schaltjahrregeln bezeichnen.

Dürfen Werte Felder enthalten, die nicht definiert sind?

Nein. Unbekannte Schlüssel werden abgelehnt, damit Tippfehler und veraltete Vorlagenzuordnungen sichtbar werden.

Was passiert, wenn ein Pflichtfeld nur Leerzeichen enthält?

Es gilt als leer, die Prüfung schlägt fehl und die Meldung nennt das betroffene Feld. Nur ein echter Inhalt erfüllt ein Pflichtfeld; fehlende optionale Felder werden einfach als nicht angegeben aufgeführt.

Wird „ja“ für ein Kontrollkästchen oder eine als Text geschriebene Ganzzahl akzeptiert?

Nein. Nichts wird für Sie umgewandelt: Ein Ja-Nein-Feld braucht den Wert wahr oder falsch, nicht das Wort ja oder die Ziffer 1, und eine Ganzzahl muss als Zahl ankommen, nicht als Text wie 12.

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/fill-form-fields

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/fill-form-fields \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fields":[{"name":"full_name","type":"text","required":true},{"name":"age","type":"integer","required":false}],"values":{"full_name":"Ada Lovelace","age":36}}'

const res = await fetch("https://api.kit.forhosting.com/pdf/fill-form-fields", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "fields": [
      {
        "name": "full_name",
        "type": "text",
        "required": true
      },
      {
        "name": "age",
        "type": "integer",
        "required": false
      }
    ],
    "values": {
      "full_name": "Ada Lovelace",
      "age": 36
    }
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/fill-form-fields",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "fields": [
        {
            "name": "full_name",
            "type": "text",
            "required": true
        },
        {
            "name": "age",
            "type": "integer",
            "required": false
        }
    ],
    "values": {
        "full_name": "Ada Lovelace",
        "age": 36
    }
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/fill-form-fields", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"fields":[{"name":"full_name","type":"text","required":true},{"name":"age","type":"integer","required":false}],"values":{"full_name":"Ada Lovelace","age":36}}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"fields":[{"name":"full_name","type":"text","required":true},{"name":"age","type":"integer","required":false}],"values":{"full_name":"Ada Lovelace","age":36}}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/fill-form-fields", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "fields": [
    {
      "name": "full_name",
      "type": "text",
      "required": true
    },
    {
      "name": "age",
      "type": "integer",
      "required": false
    }
  ],
  "values": {
    "full_name": "Ada Lovelace",
    "age": 36
  }
}

Beispiel-Antwort

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

Da die Prüfung deterministisch erfolgt und keine PDF-Datei öffnet oder verändert, eignet sie sich sowohl als Vorabkontrolle im Browser als auch als verlässliche API-Sicherung in automatisierten Abläufen.

Verstehen Sie die strenge Werteprüfung

Eine Ganzzahl muss als JSON-Zahl ohne Nachkommastellen eingehen, nicht als Zeichenfolge "12". Zahlenfelder akzeptieren ausschließlich endliche JSON-Zahlen. Sie erscheinen dann in missing_optional und werden nicht nach validated_values übernommen.

Prüfen Sie die Daten vor der PDF-Erzeugung

Das Objekt validated_values bewahrt die angenommenen JSON-Werte unverändert: Datumsangaben werden nicht formatiert, Zahlen nicht gerundet, Auswahlen nicht umsortiert und Standardwerte nicht erfunden. Interaktive Kontrollen sind im Browser möglich; in der automatisierten Dokumentproduktion kostet eine API-Anfrage $0.002.

Integrationsbeispiele

Vorlagenzuordnungen testen

Kontrollieren Sie, ob Ausgabeschlüssel und JSON-Typen Ihrer Anwendung weiterhin zum Vertrag einer versionierten PDF-Vorlage passen.

Technische Fragen

Was geschieht, wenn ein Pflichtfeld fehlt?

Die Anfrage endet mit einem invalid_input-Fehler, in dem das fehlende Pflichtfeld genannt wird.

Werden numerische Zeichenfolgen in Zahlen umgewandelt?

Nein. Die Prüfung ist streng; eine Zahl oder Ganzzahl muss als JSON-Zahl angegeben werden.

Was kostet eine API-Anfrage?

Jede Anfrage kostet $0.002. Die deterministische Prüfung kann außerdem im Browser ausgeführt werden.

Vollständige KIT-Dokumentation lesen →

Pflichtfelder und Werte in PDF-Formularen validieren

Im Browser ausführen – kostenlos

Definieren Sie den Formularvertrag eindeutig

Verstehen Sie die strenge Werteprüfung

Prüfen Sie die Daten vor der PDF-Erzeugung

Anwendungsfälle

Onboarding-Formulare vorab prüfen

Dokumentenstapel absichern

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Limits

Fehler

Technische Hinweise

Verstehen Sie die strenge Werteprüfung

Prüfen Sie die Daten vor der PDF-Erzeugung

Integrationsbeispiele

Vorlagenzuordnungen testen

Technische Fragen

danke