ForHosting KIT · Prüfen & Validieren

Postleitzahl prüfen

Dieses Werkzeug prüft, ob eine eingegebene Postleitzahl dem für ein bestimmtes Land gültigen Format entspricht, etwa fünf Ziffern in Deutschland oder eine abweichende Zeichenfolge mit Buchstaben in anderen Ländern. Es erkennt Format-Abweichungen sofort, prüft aber nicht, ob die Postleitzahl tatsächlich einem realen Ort zugeordnet ist.

● StabilKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Warum das Format je nach Land völlig unterschiedlich ist

In Deutschland besteht eine Postleitzahl immer aus fünf Ziffern vor dem Ort, in anderen Ländern gehören Buchstaben dazu, ist die Länge kürzer oder folgt die Reihenfolge einem völlig anderen Muster. Ein Formular, das nur die deutsche Regel prüft, lehnt ausländische Adressen dadurch fälschlich ab oder akzeptiert umgekehrt offensichtlich falsche PLZ-Angaben, weil es das jeweilige Länderformat gar nicht kennt und pauschal fünf Ziffern erwartet.

Was die Prüfung genau kontrolliert

Die Prüfung vergleicht die eingegebene Postleitzahl mit dem für das gewählte Land bekannten Format, also Länge, erlaubten Zeichen und üblicher Schreibweise, und meldet Abweichungen sofort mit einer kurzen Begründung. Das Ergebnis zeigt, ob die Eingabe formal zum gewählten Land passt, sodass sich ein Tippfehler oder ein versehentlich falsch ausgewähltes Land noch rechtzeitig vor dem Absenden eines Formulars zuverlässig erkennen lässt.

Format-Prüfung statt Existenzprüfung

Die Prüfung erkennt, ob eine Postleitzahl formal korrekt aufgebaut ist, nicht, ob sie tatsächlich einem realen Ort zugeordnet ist. Eine erfundene, aber formal gültige Postleitzahl wird deshalb als formal korrekt angezeigt, selbst wenn es den betreffenden Ort so gar nicht gibt. Für die Zuordnung zu einem echten Ort wäre ein zusätzlicher Abgleich mit einer Liste tatsächlich vergebener Postleitzahlen nötig, den diese reine Format-Prüfung bewusst nicht vornimmt.

Direkt im Formular einsetzbar

Weil die Prüfung vollständig im Browser läuft, lässt sie sich unmittelbar bei der Eingabe in ein Formular einsetzen, ohne spürbare Wartezeit für die Person, die gerade tippt. Die eingegebene Postleitzahl wird dabei nicht an einen Server übertragen, was die Einbindung auch in Formulare mit sensiblen Kundendaten unproblematisch macht, etwa in einem Bestellformular, das täglich viele Adressen aus unterschiedlichen Ländern entgegennimmt.

Anwendungsfälle

Versandformular für mehrere Länder

Ein Online-Shop der Bäckerei Hoffmann e. K. liefert inzwischen auch ins europäische Ausland und prüft die Postleitzahl im Bestellformular passend zum jeweils gewählten Land.

Import einer alten Kundenliste

Beim Import einer gewachsenen Kundenliste prüft Thomas Müller stichprobenartig, welche gespeicherten Postleitzahlen nicht zum jeweils hinterlegten Land passen.

Rechnungsadressen vor dem Versand kontrollieren

Vor dem Druck der Rechnungen prüft die Buchhaltung der Weber Metallbau GmbH, ob alle hinterlegten Postleitzahlen dem deutschen Fünf-Ziffern-Format entsprechen.

Häufige Fragen

Was kostet die Formatprüfung einer Postleitzahl?

Nichts. Sie läuft direkt im Browser, kostenlos, ohne Anmeldung und ohne Limit.

Prüft das Werkzeug, ob die Postleitzahl wirklich existiert?

Nein. Geprüft wird nur das Format nach Land, nicht die tatsächliche Zuordnung zu einem realen Ort.

Verlässt die eingegebene Postleitzahl meinen Browser?

Nein. Die Prüfung findet vollständig in Ihrem Browser statt.

Erkennt das Werkzeug auch Postleitzahlen mit Buchstaben?

Ja, sofern das Format des gewählten Landes Buchstaben vorsieht, wird das bei der Prüfung berücksichtigt.

Was passiert, wenn ich kein Land angebe?

Ohne Länderangabe kann das Format nicht eindeutig geprüft werden, da dieselbe Zeichenfolge in unterschiedlichen Ländern gültig oder ungültig sein kann.

Kann ich damit eine ganze Kundenliste auf einmal prüfen?

Im Browser prüfen Sie eine Postleitzahl nach der anderen. Für ganze Listen steht dieselbe Funktion über die API zur Verfügung.

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/verify/postal-code

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/verify/postal-code \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/verify/postal-code", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/verify/postal-code",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/postal-code", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/postal-code", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Beispiel-Antwort

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

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 →

Im Browser ausführen – kostenlos