POST AI agent ready /v1/phone

Telefonvalidierungs-API – Kostenloser Nummernparser

Analysiert und validiert eine Telefonnummer. Gibt formatierte Versionen (E.164, national), Ländercode und Ländernamen zurück.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/phone \
  -H "Content-Type: application/json" \
  -d '{"phone":"+14155552671","country":"US"}'

When to use this API

Telefonnummern in einer Kontaktdatenbank normalisieren

Benutzer geben Telefonnummern in Dutzenden von Formaten ein: „415-555-2671“, „(415) 555 2671“, „+1 415.555.2671“. Analysieren Sie jeden einzelnen über diesen Endpunkt, um das standardisierte E.164-Format für die Speicherung zu erhalten. Verwenden Sie das nationale_Format für die Anzeige in der Benutzeroberfläche.

Leiten Sie SMS-Nachrichten nach Land weiter

Bevor Sie eine SMS über Ihren Messaging-Anbieter senden, validieren Sie die Telefonnummer und extrahieren Sie die Landesvorwahl. Leiten Sie Nachrichten über regionalspezifische SMS-Gateways weiter, um Kosten zu senken und die Zustellraten zu verbessern.

Blockieren Sie ungültige Nummern in Anmeldeformularen

Bestätigen Sie die Telefonnummern bei der Einreichung des Registrierungsformulars. Lehnen Sie ungültige Zahlen sofort ab und zeigen Sie den Benutzern das nationale Format als Bestätigung dessen, was geparst wurde, um Tippfehler zu erkennen, bevor sie Ihre Datenbank erreichen.

Frequently asked questions

Welche Telefonnummernformate werden akzeptiert?

Der Endpunkt akzeptiert das internationale Format (+14155552671), das nationale Format ((415) 555-2671) und die gängigsten Varianten mit Bindestrichen, Punkten oder Leerzeichen. Die Einbeziehung des Ländercode-Präfixes liefert die genauesten Ergebnisse.

Wann sollte ich den Länderparameter verwenden?

Verwenden Sie den Länderparameter, wenn die Telefonnummer kein Ländervorwahlpräfix enthält (z. B. „4155552671“ ohne „+1“). Der Länderhinweis teilt dem Parser mit, welcher Nummerierungsplan angewendet werden soll.

Was ist das E.164-Format?

E.164 ist der internationale Standard für Telefonnummern. Es beginnt mit einem „+“, gefolgt von der Landesvorwahl und der Teilnehmernummer, ohne Leerzeichen oder Satzzeichen. Beispiel: +14155552671.

Wird dadurch bestätigt, dass die Telefonnummer aktiv ist?

Nein. Dieser Endpunkt validiert nur Format und Struktur. Es erfolgt weder ein Anruf noch eine SMS an die Nummer, um zu überprüfen, ob sie aktiv ist.

Kann ich Festnetz- und Mobilfunknummern validieren?

Ja. Der Parser verarbeitet sowohl Festnetz- als auch Mobiltelefonnummernformate. Die Validierung erfolgt auf Grundlage der Nummerierungsplanregeln des Landes.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.