← Zurück zum Blog

API zur Telefonnummern-Validierung: Möglichkeiten und Grenzen

API zur Telefonnummern-Validierung: Möglichkeiten und Grenzen

Eine API zur Validierung von Telefonnummern prüft, ob eine Nummer nach den internationalen Nummernplanregeln wohlgeformt ist, und liefert Region und Leitungstyp, etwa Mobilfunk oder Festnetz, ohne ein Netz zu kontaktieren. Sie beantwortet „Könnte das eine echte Nummer sein?“ und nicht „Ist diese Nummer gerade geschaltet?“

Diese Unterscheidung entscheidet, welche Art von Dienst Sie brauchen. Validierung auf Formatebene ist schnell, im Betrieb kostenlos und privat, während alles, was den Live-Status meldet, von einer Datenquelle auf Carrier-Niveau und Kosten pro Abfrage abhängt. Viele Teams zahlen für Letzteres, wo Ersteres ihr eigentliches Problem gelöst hätte.

Was regelbasierte Validierung gut kann

Der Nummernplan jedes Landes ist öffentlich: Ländervorwahlen, zulässige Längen, gültige Bereiche von Ortsnetzkennzahlen und Präfixen sowie welche Präfixe Mobilfunk, Festnetz oder anderen Diensten zugeteilt sind. Ein auf diesen Regeln aufbauender Validator, typischerweise eine Bibliothek auf Basis der libphonenumber-Metadaten von Google, kann viel leisten:

  • Normalisieren. „(415) 555-0132“, „415-555-0132“ und „+1 415 555 0132“ in dieselbe E.164-Zeichenfolge überführen, damit Ihre Datenbank nicht sechs Schreibweisen einer Nummer hält.
  • Fehlerhafte Eingaben abweisen. Falsche Länge, unmögliches Präfix oder ein Buchstabe an der falschen Stelle wird im Formular abgefangen, bevor die Eingabe Ihren SMS-Anbieter erreicht und Geld kostet.
  • Region ableiten. Land oder Region ergeben sich aus Vorwahl und Präfix, was bei Routing, Lokalisierung und Standardformatierung hilft.
  • Leitungstyp klassifizieren. Mobilfunk, Festnetz und mehrere weitere Kategorien werden aus Präfixzuteilungen abgeleitet.

Da die Arbeit reine Berechnung ist, liefert sie sofort, und die Nummer muss nie an einen externen Anbieter gesendet werden. Das ist ein Datenschutzvorteil, da Telefonnummern in den meisten Rechtsordnungen personenbezogene Daten sind. Der Telefonnummern-Checker von ipto funktioniert so: Er nutzt einen selbst gehosteten Parser, und seine Ausgabe beruht auf Nummernplanregeln, ohne Live-Carrier-Abfrage. Geben Sie eine Nummer im internationalen Format ein oder wählen Sie ein Land, um eine lokale Nummer zu interpretieren.

Was sie Ihnen nicht sagen kann

Regelbasierte Validierung hat harte Grenzen, die man kennen sollte, bevor man einen Ablauf darum herum entwirft.

  • Ob die Nummer aktiv ist. Eine Nummer kann alle Regeln erfüllen und trotzdem nicht vergeben, abgeschaltet oder an einen neuen Inhaber recycelt sein.
  • Wem sie gehört. Nummernplanregeln sagen nichts über den Teilnehmer.
  • Welcher Betreiber sie derzeit bedient. Durch Nummernportierung ist der ursprüngliche Präfixinhaber oft nicht der aktuelle Carrier.
  • Ob die Leitung ein VoIP-Dienst ist. Die präfixbasierte Typerkennung ist ungefähr, und virtuelle Nummern werden häufig aus gewöhnlichen Bereichen zugeteilt.

In der Terminologie von ipto bedeutet „valide“ „plausibel nach den Nummernplanregeln“. Für harte Fakten zur Erreichbarkeit brauchen Sie entweder eine Live-Carrier- oder HLR-artige Abfrage bei einem Anbieter mit diesem Zugang oder einen praktischen Test, etwa einen Einmalcode zu senden und zu sehen, ob der Nutzer ihn eingibt.

Zwischen beiden Ansätzen wählen

Gehen Sie von der Entscheidung aus, die Sie treffen wollen. Bereinigen Sie eine Kontaktliste, normalisieren Eingaben bei der Anmeldung oder entscheiden, ob eine Landesflagge angezeigt wird, genügt die regelbasierte Validierung, und eine kostenpflichtige Live-Abfrage wäre verschwendetes Geld. Schützen Sie einen Ablauf mit hohem Wert, etwa die Kontowiederherstellung, ist der billigste Erreichbarkeitstest meist der Verifizierungscode selbst: Er belegt die Kontrolle über die Nummer, was keine Abfrage leistet.

Eine kostenpflichtige Live-Abfrage lohnt sich, wenn Sie in großer Menge senden und vermeiden wollen, für Nachrichten an tote Nummern zu zahlen, oder wenn Sie bestimmte Leitungskategorien mit hoher Sicherheit unterscheiden müssen. Selbst dann lassen Sie zuerst die kostenlose Formatprüfung laufen. Sie entfernt offensichtlichen Müll, sodass Sie nur für Nummern zahlen, die plausibel echt sein könnten.

Wo IP-seitige Tools hineinpassen

Telefondaten sind neben Netzwerk- und E-Mail-Daten nützlicher. Die IP-zu-Carrier-Abfrage ist etwas anderes als eine Carrier-Abfrage zu einer Telefonnummer: Sie ordnet eine als mobil klassifizierte IP-Adresse über das MCC-/MNC-Verzeichnis ihrem Betreiber zu, auf Netzebene, nie pro Teilnehmer. Der E-Mail-Checker deckt Syntax, MX-Einträge und Wegwerf-Domains ab, und der Fraud-Score-Checker nimmt ein Telefonergebnis als einen von vier optionalen Inputs neben IP, E-Mail und User-Agent auf. In diesem Score erhöht eine Nummer, die die Validierung nicht besteht, das Risiko, während eine plausible wenig beiträgt, was dazu passt, wie schwach eine Formatprüfung als Beleg für Legitimität tatsächlich ist.

Zur Vertiefung, wie man ein Konto aus mehreren Blickwinkeln beurteilt, siehe Validierung von Wegwerf-E-Mails erklärt.

Klare Antworten

Eine Telefonnummern-Validierungs-API prüft, ob eine Nummer nach den internationalen Nummernplanregeln wohlgeformt ist, und liefert Region und Leitungstyp, etwa Mobilfunk oder Festnetz.
Nicht, wenn sie allein auf Nummernplanregeln beruht. Um zu bestätigen, dass eine Nummer geschaltet ist, wem sie gehört oder welcher Carrier sie derzeit bedient, braucht es eine Live-Abfrage auf Carrier-Ebene oder einen an die Nummer gesendeten Verifizierungscode.
Er nutzt einen selbst gehosteten Parser auf Basis von Nummernplanregeln, sodass Nummern nicht an einen externen Validierungsanbieter gesendet werden. Er führt keine Live-Carrier-Abfrage durch und liefert Formatgültigkeit, Region und Leitungstyp.
← Zurück zum Blog