ForHosting KIT · Prüfen & Validieren

Ist diese Adresse gültig?

Dieses Werkzeug prüft eine frei eingegebene Adresse auf Plausibilität und zerlegt sie in einzelne Felder: Straße, Hausnummer, Postleitzahl, Ort und Land. Es eignet sich für die Kontrolle von Kundenadressen vor dem Speichern in einer Rechnung, einem Formular oder einer Kundendatenbank.

● Betapro Anfrage + pro Element$0.003

Ausführen — $0.003 + $0.0135/Element API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Online ausführen

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Warum freie Adressfelder häufig Fehler enthalten

Wird eine Adresse in ein einziges freies Textfeld eingegeben, landen Straße, Hausnummer und Ort oft in falscher Reihenfolge, mit Tippfehlern oder ganz ohne erkennbare Trennung zwischen den einzelnen Angaben. Für eine Rechnung, einen Versand oder einen Eintrag in der Buchhaltung reicht ein solches Freitextfeld selten aus, ohne die Angaben vorher sorgfältig zu bereinigen und in klar getrennte, eindeutig benannte Felder zu überführen.

Aufteilung in einzelne, nutzbare Felder

Die Prüfung zerlegt die eingegebene Adresse in Straße, Hausnummer, Postleitzahl, Ort und Land und weist auf unplausible Kombinationen hin, etwa eine Postleitzahl, die zu keinem bekannten Ort passt, oder eine Hausnummer, die im Text an einer ungewöhnlichen Stelle steht. Das Ergebnis lässt sich direkt in strukturierte Felder einer Datenbank, eines Formulars oder einer Rechnungsvorlage übernehmen, ohne die Angaben von Hand neu abzutippen.

Plausibilität, keine Zustellprüfung

Die Bewertung erkennt, ob eine Adresse in sich stimmig aufgebaut ist, prüft aber nicht, ob unter dieser Adresse tatsächlich jemand erreichbar ist oder ob die genannte Hausnummer real existiert. Für eine belastbare Zustellprüfung, etwa vor einem Versand mit Nachnahme, bleibt deshalb eine separate Kontrolle erforderlich, die über die reine Plausibilität der Textangaben hinausgeht und die tatsächliche Erreichbarkeit vor Ort bestätigt.

Nützlich für Rechnungen und Kundendaten

Gerade bei Rechnungsadressen, die später bei der Buchhaltung, für eine E-Rechnung oder für den GoBD-konformen Beleg verarbeitet werden, lohnt sich eine Prüfung vor dem Speichern, weil Fehler an dieser Stelle später nur mit Aufwand korrigierbar sind. Über die API lässt sich die Prüfung in ein bestehendes Bestellformular oder eine gewachsene Kundendatenbank einbinden, statt jede Adresse einzeln von Hand zu kontrollieren.

Anwendungsfälle

Kundenadressen vor der Rechnungsstellung prüfen

Die Buchhaltung der Weber Metallbau GmbH prüft neu erfasste Kundenadressen vor der ersten Rechnung, um spätere Rückläufer wegen unvollständiger Angaben zu vermeiden.

Ein Bestellformular ohne strenge Feldtrennung

Ein Online-Shop lässt Kunden die Adresse zunächst frei eingeben und zerlegt sie anschließend automatisch in Straße, PLZ und Ort für den Versand.

Datenbereinigung einer alten Kundenliste

Katrin Baumann bereinigt eine über Jahre gewachsene Kundenliste, in der Adressen uneinheitlich erfasst wurden, und lässt jede Adresse einzeln in strukturierte Felder aufteilen.

Häufige Fragen

Was kostet eine Adressprüfung?

$0.003 pro Anfrage zuzüglich $0.0135 pro Einheit. Eine einzelne Adresse kostet damit klar unter zwei US-Cent.

Wird die geprüfte Adresse gespeichert?

Die Adresse wird zur Prüfung verarbeitet, aber nicht dauerhaft gespeichert oder für andere Zwecke weiterverwendet.

Prüft das Werkzeug, ob unter der Adresse jemand wohnt?

Nein. Geprüft wird die Plausibilität des Aufbaus, nicht die tatsächliche Erreichbarkeit oder Existenz der Hausnummer.

Funktioniert die Prüfung auch für Adressen außerhalb Deutschlands?

Ja, die Prüfung ist nicht auf ein einzelnes Land beschränkt, die Genauigkeit kann je nach Land und Adressformat variieren.

Lässt sich das Ergebnis direkt in eine Rechnung übernehmen?

Ja. Die zerlegten Felder – Straße, Hausnummer, PLZ, Ort, Land – lassen sich direkt in ein Rechnungs- oder Formularsystem übertragen.

Kann ich die Adressprüfung kostenlos im Browser nutzen?

Nein, sie nutzt ein Sprachmodell und ist deshalb kostenpflichtig, unabhängig davon, ob Sie sie über die Web-Oberfläche oder die API aufrufen.

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/address

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/address \
  -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/address", {
  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/address",
    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/address", 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/address", 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.address",
  "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.003

pro Element$0.0135

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.
`422`	`task_failed`	Die Aufgabe ist fehlgeschlagen und wird nicht berechnet.

Vollständige KIT-Dokumentation lesen →