Überprüfung der Handynummer (HLR-Lookup)

Die Überprüfung der Mobilfunknummer ist ein HLR (Home Location Register)-Abfragedienst, der die Existenz einer Mobilfunknummer überprüfen und Informationen wie den zugehörigen Mobilfunkanbieter liefern kann.

Der Dienst führt eine erste HLR-Abfrage und -Überprüfung im Mobilfunknetz durch, identifiziert das Format der Mobilfunknummern und reichert die Informationen an, wie z.B. den Status der SIM-Karte (aktiv, gesperrt, ausgesetzt) und jegliche Änderungen des Mobilfunkanbieters.

Der Dienst ist in 56 Ländern und bei über 260 Anbietern verfügbar.

BEISPIEL FÜR EINE ANFRAGE

POST /mobile-start/{mobiltelefonnummer}

Um den Dienst zu nutzen, reicht es aus, eine POST-Anfrage an den Endpunkt /mobile-start/{mobiltelefonnummer} zu senden und die zu überprüfende Mobilfunknummer als Parameter zu übergeben. Die Nummer muss immer mit der internationalen Vorwahl beginnen (z.B. +49).

POST /mobile-start/+49123456789

Bei der Anfrage kann und sollte immer ein Callback definiert werden, um eine Benachrichtigung zu erhalten, wenn die Antwort verfügbar ist.

{
  "callback": {
    "url": "https://ihr-server.de/123232",
    "custom": 123
  }
}

BEISPIEL FÜR EINE ANTWORT

POST /mobile-start/{mobiltelefonnummer}

Die Antwort wird in der Regel innerhalb weniger Sekunden zurückgesendet und enthält Informationen wie:

{
  "data": {
    "isPossible": true,
    "isValid": true,
    "regionCode": "DE",
    "isValidNumberForRegion": true,
    "numberType": "MOBILE",
    "requestedNumber": "0049123456789",
    "formattedNumber": "+49123456789",
    "createdAt": "2024-09-06T13:56:19+00:00",
    "updatedAt": "2024-09-06T13:56:19+00:00",
    "state": "DONE",
    "network": "MNO - Vodafone Deutschland",
    "originalNetwork": "MNO - Telekom Deutschland",
    "roaming": false,
    "ported": true,
    "country": "Deutschland",
    "countryPrefix": "49",
    "details": "DELIVERED_TO_HANDSET",
    "id": "66db0a03e8ba8710290e3c0f"
  },
  "success": true,
  "message": "",
  "error": null
}

Falls die Verarbeitung in den ersten 10 Sekunden nicht möglich ist, wird eine Teilantwort mit dem Status NEW und der ID zurückgesendet, um die Anfrage asynchron zu bearbeiten.

{
  "data": {
    "isPossible": true,
    "isValid": true,
    "regionCode": "DE",
    "isValidNumberForRegion": true,
    "numberType": "MOBILE",
    "requestedNumber": "0049123456789",
    "formattedNumber": "+49123456789",
    "createdAt": "2024-09-06T13:56:19+00:00",
    "updatedAt": "2024-09-06T13:56:19+00:00",
    "state": "NEW",
    "network": "",
    "originalNetwork": "",
    "roaming": ,
    "ported": ,
    "country": "",
    "countryPrefix": "",
    "details": "",
    "id": "66db0a03e8ba8710290e3c0f"
  },
  "success": true,
  "message": "",
  "error": null
}

In diesem Fall ist eine zweite Anfrage erforderlich, um die benötigten Daten zu erhalten.

BEISPIELANFRAGE

GET /mobile-start/{id}

Der Endpunkt zur Überprüfung des Status der Anfrage ist /mobile-start/{id}, und die Methode ist GET. Wenn ein Callback implementiert ist, werden Sie benachrichtigt, sobald Ihre Anfrage bearbeitet und Ihre Daten verfügbar sind.

Hier ist ein Beispiel für eine Anfrage mit der ID, die im vorherigen POST-Aufruf erhalten wurde.

GET /mobile-start/66db0a03e8ba8710290e3c0f

Wenn der Status DONE ist, wird die Antwort dieselben Daten enthalten wie die in der vorherigen POST-Antwort angegebenen.

Die Überprüfung der Mobilfunknummer ist ein unverzichtbares Werkzeug für Unternehmen, die SMS-Kommunikationen versenden, oder für Tech-Unternehmen, die Lösungen mit dieser Funktion entwickeln, wie SMS-Plattformen, CRM-Systeme und E-Commerce-Websites.

Der Dienst ermöglicht es, bestehende Nummern zu validieren und Datenbanken von inaktiven Kontakten zu bereinigen, wodurch die Effizienz von Kampagnen und Kommunikationen bei sehr wettbewerbsfähigen Kosten optimiert wird.