HLR API von CaptainVerify

HLR API

Mit der API von CaptainVerify können Sie die Verifizierung durch HLR Lookup nahtlos in Ihre eigenen Apps und Anwendungen integrieren. Weitere Informationen finden Sie in unserer HLR Dokumentation.

API-Schlüssel

Zum Generieren des API-Schlüssels ist ein Benutzerkonto erforderlich.

Anfrage

Rufen Sie einfach das GET-Protokoll unter der folgenden URL auf, um Anfragen an die API zu senden:

https://api.captainverify.com/verify?phone={PHONE_NUMBER}&apikey=XXXXXXXXXXXXXXXXXXXX

Ersetzen Sie {PHONE_NUMBER} durch die zu verifizierende Handynummer (im internationalen Format: +491...).

Nutzungslimits

Die API ist auf maximal 2 gleichzeitige Verbindungen und 50 Verifizierungen pro Minute beschränkt. Bitte stellen Sie bei der Integration der API sicher, dass Ihre Anwendung die Anforderungen erfüllt.

Antwort

Sie erhalten eine json-Tabelle mit den folgenden Variablen:

Variablen	Möglicher Wert
status	true, false. Anfragestatus.
credits	89 Auf Ihrem Konto verfügbare Credits.
message	default : null Bei falschen Status erhalten Sie eine Fehlermeldung.
requested_number	491000000000 Angeforderte Handynummer.
formatted_number	+491000000000 Handynummer im internationalen Format.
network	T-MOBILE Name des Netzwerks.
original_network	TELEFONICA Ursprünglicher Name des Netzwerks.
roaming	true, false Aktueller Roaming-Status.
ported	true, false Ob der Nutzer mit Rufnummermitnahme den Anbieter gewechselt hat.
country	GERMANY Vollständiger Landesname für die angeforderte Nummer.
country_prefix	49 Ländervorwahl für die angeforderte Nummer.
details	DELIVERED_TO_HANDSET, UNDELIVERABLE_NOT_DELIVERED DELIVERED_TO_HANDSET : Die HLR-Verifizierung wurde erfolgreich abgeschlossen (Nummer vergeben). UNDELIVERABLE_NOT_DELIVERED: Die HLR-Verifizierung wurde ohne Erfolg abgeschlossen (Nummer nicht vergeben).
result	Status der Nummer: Gültig, Ungültig, Unbekannt Wenn Ihre Credits aufgebraucht sind, wird der Status unbekannt angezeigt.

Warum eine HLR API integrieren?

Eine Liste mit Mobilfunknummern altert schnell. Leitungen werden gekündigt, Nummern wechseln den Netzbetreiber, andere enthalten einen Tippfehler und haben nie existiert. Jede SMS an eine ungültige Nummer wird berechnet, kommt aber nie an. Bei einer Kampagne mit mehreren tausend Nachrichten belasten diese verlorenen Sendungen direkt das Budget, ohne den geringsten Rücklauf zu erzeugen.

Das Problem geht über die SMS hinaus. In der Telefonakquise kostet eine mit gekündigten Nummern belastete Liste den Teams Zeit: Jeder Anruf auf einer toten Leitung ist ein Anruf, der nicht zustande kommt. Die Kampagnenstatistiken werden unlesbar, die SMS-Zustellbarkeit verschlechtert sich und es wird unmöglich, eine ignorierte Nachricht von einer nie zugestellten Nachricht zu unterscheiden.

Eine HLR API packt das Problem an der Wurzel. Das HLR (Home Location Register) ist das Register der Netzbetreiber, das den Status der Mobilfunkleitungen erfasst. Durch die Abfrage des Betreibernetzes in Echtzeit bestätigt die API, dass eine Leitung aktiv ist, bevor Sie sie kontaktieren. Sie senden nicht mehr blind und zahlen nicht mehr dafür, Nummern zu erreichen, die nicht mehr existieren.

Anwendungsfälle der HLR API

Bereinigung einer Mobilfunkliste vor einer SMS-Kampagne

Lassen Sie vor einem Massenversand jede Nummer durch die API prüfen. Aktive Leitungen werden behalten, gekündigte oder ungültige Nummern werden aus der Liste entfernt. Sie zahlen nur für SMS, die eine echte Chance auf Zustellung haben, und Ihre Kampagnenwerte spiegeln die Qualität Ihrer Botschaft wider statt der Abnutzung Ihrer Datenbank.

Filterung vor der Telefonakquise

Ein Callcenter verliert mit jeder gewählten toten Nummer Geld. Indem Sie den Status der Leitungen vorab prüfen, geben Sie nur aktive Nummern an die Teams weiter. Die Vertriebsmitarbeiter verbringen ihre Zeit damit, mit Interessenten zu sprechen, statt Fehlermeldungen der Netzbetreiber anzuhören. Die Kosten pro nützlichem Kontakt sinken automatisch.

Erkennung gekündigter Nummern in einem CRM

Die Kontaktdatensätze eines CRM verschlechtern sich unbemerkt. Eine regelmäßige HLR-Prüfung identifiziert gekündigte Leitungen und ermöglicht es, diese Datensätze zu markieren, eine Aktualisierung anzustoßen oder auf einen anderen Kontaktkanal zu wechseln. Ihre Datenbank bleibt nutzbar, statt tote Nummern anzusammeln, die alle Ihre Kennzahlen verfälschen.

Ermittlung des tatsächlichen Netzbetreibers trotz Rufnummernportierung

Eine portierte Nummer behält ihre ursprüngliche Vorwahl, gehört aber inzwischen zu einem anderen Netzbetreiber. Die Antwort der API unterscheidet das aktuelle Netz (network) vom ursprünglichen Netz (original_network). Sie wissen, welcher Netzbetreiber die Leitung tatsächlich verwaltet, eine wertvolle Information für das Routing Ihrer SMS oder die Analyse der Zusammensetzung Ihrer Liste.

Häufige Fragen zur HLR API

Was genau prüft die HLR API?

Die API fragt beim Netzbetreiber den Status der Mobilfunkleitung ab. Die JSON-Antwort enthält den Status der Anfrage, die international formatierte Nummer, das aktuelle Netz und das ursprüngliche Netz. Der Vergleich dieser beiden letzten Felder zeigt, ob die Nummer zu einem anderen Netzbetreiber portiert wurde.

Arbeitet die API in Echtzeit?

Ja. Jede Anfrage löst in dem Moment, in dem Sie sie senden, eine Abfrage des Betreibernetzes aus. Zwei dokumentierte Grenzen regeln die Nutzung: maximal 2 gleichzeitige Verbindungen und 50 Prüfungen pro Minute. Für große Volumen genügt es, Ihre Aufrufe unter Einhaltung dieser Schwellen zu takten.

Was kostet das?

Die Abrechnung erfolgt über Credits, und jede Antwort der API enthält ein Feld credits, mit dem Sie Ihren Verbrauch direkt aus Ihren Aufrufen heraus verfolgen können. Die detaillierten Preise für HLR-Prüfungen finden Sie auf der Seite HLR Lookup.