ForHosting KIT · Entwickler-Tools

Kölner Phonetik

Müller, Mueller und Muller erhalten alle den Code 657, Schmidt und Schmied teilen sich die 862, sodass Schreibvarianten eines Namens zusammenfinden. So erkennen Sie mögliche Dubletten in Registern, Kundenlisten und Stammbäumen. 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

Rechenbeispiel

Wenn Sie eingeben

Text: Müller

Erhalten Sie

Code: 657
Länge: 3
Normalisiert: MULLER
Buchstabenanzahl: 6

Die Kölner Phonetik bildet Nachnamen und Vornamen auf eine kurze Ziffernfolge ab, sodass ähnlich klingende Varianten denselben Schlüssel teilen. Standesregister, CRM-Deduplizierung und Genealogie-Werkzeuge nutzen sie, wenn Müller zu Mueller passen oder Schneider mit Schnyder gruppiert werden soll – ohne vollständiges phonetisches Modell. Sie erhalten ein stabiles code-Feld und die normalisierte Buchstabenfolge, um zu prüfen, warum zwei Datensätze kollidierten.

Was die Kölner Phonetik kodiert und warum Namen kollidieren

Die Kölner Phonetik wurde für deutschsprachige Personenlisten entworfen, in denen Schreibvarianten häufig sind: Umlaute als Digraphen, stummes H, weiches C gegen hartes C und X mit zwei Codes. Der Algorithmus beansprucht keine IPA-Genauigkeit; er liefert einen kompakten, deterministischen Schlüssel, der ähnlich ausgesprochene Namen bündelt. Die Buchstaben A, E, I, J, O, U und Y werden auf null abgebildet und verschwinden danach, sofern sie den Code nicht eröffnen.

H wird vollständig ignoriert. Konsonanten werden mit Kontextregeln auf eins bis acht abgebildet – zum Beispiel wird P vor H zu drei wie F, D oder T vor C, S oder Z zu acht wie S, und X zu achtundvierzig, sofern es nicht auf C, K oder Q folgt. Nach dem Buchstabendurchlauf fallen aufeinanderfolgende gleiche Ziffern zusammen, sodass Schmidt und Schmied beide auf acht-sechs-zwei schrumpfen, und verbleibende Nullen außer einer führenden Null entfallen.

Deshalb ergeben Müller, Mueller und Muller jeweils sechs-fünf-sieben, und Mayer, Meier, Maier und Mayr teilen sechs-sieben. Genealogie- und Stammdaten-Teams behandeln gleiche Codes als Kandidatenmatch, nicht als Identitätsbeweis: Zweitnamen, Ehenamen und Transkriptionsfehler erfordern weiterhin menschliche oder sekundäre Prüfungen. Nutzen Sie das zurückgegebene Feld normalized, um zu sehen, welche Buchstaben nach dem Entfernen von Leerzeichen, Bindestrichen und Ziffern vor der Kodierung übrig blieben.

Was Sie eingeben können und was Sie erhalten

Extrem lange Pastes über dem veröffentlichten Zeichenlimit scheitern ebenfalls, damit Edge-Worker vorhersehbar bleiben. Nichtbuchstaben erscheinen nie in normalized: Satzzeichen, Leerzeichen und Ziffern werden vor der Kodierung entfernt. Bleibt kein Buchstabe übrig – etwa text gleich 12345 oder nur Symbole – scheitert die Aufgabe mit einer Meldung über leere oder nicht alphabetische Eingabe und verlangt mindestens einen Buchstaben.

Diese Fehler werden nicht abgerechnet. Es gibt keine Dekodier-Richtung: Kölner Codes sind many-to-one und verlustbehaftet; eine Rückwärtssuche bräuchte ein externes Namenslexikon, das Sie selbst pflegen. Kombinieren Sie code-Gleichheit mit eigenen Schwellen (gleiche Postregion, ähnliches Geburtsjahr) beim Aufbau eines Match-Scores; dieser Endpunkt berechnet nur den phonetischen Schlüssel.

Beispiel: text Müller ergibt code 657 mit normalized MULLER; text Schmidt ergibt 862; text Fischer ergibt 387.

Wo die Kölner Phonetik im Alltag hilft

Kundendatenplattformen nutzen die Kölner Phonetik beim Onboarding-Merge-and-Purge, damit deutsche Nachnamen mit und ohne Umlaute keine Doppelkonten erzeugen. Migrationsskripte im öffentlichen Sektor hängen eine cologne-Code-Spalte neben soundex- oder metaphone-Spalten, wenn sie mehrquellenbasierte Bürgerauszüge vergleichen. Unterrichtsmodule zum Namensmatching brauchen ein deterministisches Orakel, das leeres Paste ablehnt statt einer leeren Zeichenkette, die ein fehlerhafter Bewerter als Match-all deuten könnte.

Bevorzugen Sie diesen Kodierer, wenn der Korpus deutsch oder mitteleuropäisch ist; für rein englisches Funkbuchstabieren nutzen Sie ein NATO-Alphabet-Werkzeug, und für englisch orientiertes Fuzzy-Matching vergleichen Sie soundex- oder metaphone-Landings statt Cologne auf angelsächsische Namen zu erzwingen. Halten Sie Anfragen bei Einzelnamen oder kurzen Token, speichern Sie den Code neben der Originalschreibweise und kodieren Sie nach dem Entfernen von Titeln wie Dr oder Frau in Ihrer eigenen Pipeline erneut, wenn Sie titelfreie Schlüssel wollen.

Anwendungsfälle

CRM und Kundendeduplizierung

Hängen Sie jedem deutschen Nachnamen einen Kölner Code an, damit Müller und Mueller vor der menschlichen Prüfung möglicher Doppelkonten zusammengeführt werden.

Genealogie und Standeslisten-Indexierung

Indizieren Sie historische Personenzeilen mit Kölner Phonetik, damit eine Suche nach Schneider auch nahe Schreibvarianten ohne Volltextmodell findet.

ETL-Match-Schlüssel für deutsche Extrakte

Fügen Sie in Migrationsjobs eine deterministische cologne-Spalte neben anderen phonetischen Schlüsseln für mehrquellenbasierte Bürger- oder Mitarbeiterdateien hinzu.

Häufige Fragen

Was ist die Kölner Phonetik?

Ein deutsches Namensvergleichsverfahren, das ein Wort mit festen Buchstabenregeln und Kontext für C, D, T, P und X auf eine kurze Ziffernfolge abbildet und danach wiederholte Ziffern sowie innere Nullen entfernt.

Warum erhalten Müller und Mueller denselben Code?

Umlaute falten auf Basisvokale (Ü→U), Vokale werden auf null abgebildet und außer einer führenden Null gestrichen, und die restlichen Konsonantencodes stimmen überein – beide normalisieren zu MULLER und code 657.

Was passiert bei leerer oder rein numerischer Eingabe?

Mindestens ein alphabetisches Zeichen (einschließlich deutscher Umlaute oder ß) ist erforderlich; leere, nur aus Leerzeichen bestehende und nicht alphabetische Zeichenketten werden abgelehnt und nicht abgerechnet.

Kann man einen Kölner Code wieder in einen Namen dekodieren?

Nein. Die Abbildung ist verlustbehaftet und many-to-one. Dieser Kodierer erzeugt nur den Zifferncode; die Rückwärtssuche braucht Ihr eigenes Namenslexikon.

Bedeutet derselbe Kölner Code, dass zwei Einträge dieselbe Person sind?

Nein. Ein gleicher Code markiert nur einen möglichen Treffer. Zweitnamen, Ehenamen und Übertragungsfehler brauchen weiterhin einen Blick von Menschen oder ein zweites Merkmal, etwa dieselbe Region oder ein ähnliches Geburtsjahr.

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/enc/cologne-phonetic

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/enc/cologne-phonetic \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Müller"}'

const res = await fetch("https://api.kit.forhosting.com/enc/cologne-phonetic", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Müller"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/cologne-phonetic",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Müller"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/cologne-phonetic", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Müller"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Müller"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/cologne-phonetic", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "text": "Müller"
}

Beispiel-Antwort

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

Technische Hinweise

Dieser Kodierer wendet die klassischen Postel-Regeln in einem reinen Worker an: Großschreibung und Umlaute falten, jeden Buchstaben mit Nachbarkontext abbilden, aufeinanderfolgende gleiche Ziffern zusammenführen und innere Nullen streichen. Leere Zeichenketten und reines Ziffernpaste scheitern mit invalid_input statt eines leeren Erfolgs.

Eingabevertrag, Antwortfelder und invalid_input-Fälle

Senden Sie per POST ein JSON-Objekt mit der Pflichtzeichenkette text (Aliase input, value, name oder s). Es wird getrimmt; reiner Leerraum und fehlende Felder scheitern mit invalid_input und benennen das Problem. Bei Erfolg spiegelt der Body text wider, liefert code als Ziffernfolge, length als Ziffernanzahl, normalized als Großbuchstabenfolge A–Z nach Umlautfaltung (Ä Ö Ü zu A O U, ß zu SS) sowie letter_count für diese Folge.

Technische Fragen

Was kostet der Kölner-Phonetik-Kodierer?

Das Browser-Werkzeug ist kostenlos. API-Anfragen nutzen das vorausbezahlte KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingabe wird nicht abgerechnet.

Vollständige KIT-Dokumentation lesen →