Original-Träger

Der Original Carrier Insight bietet Informationen mit geringer Latenz über den ursprünglich mit einer Telefonnummer verknüpften Netzbetreiber und Netzwerktyp, indem er die proprietäre Nummerierungsplanintelligenz von Vonage nutzt. Sie bietet Metadaten, ohne dass Live-Abfragen bei Drittanbietern oder Betreibern erforderlich sind, was sie für viele Anwendungsfälle schnell und zuverlässig macht.

Dieser Einblick konzentriert sich zwar auf die ursprüngliche Zuteilung und nicht auf spätere Änderungen und spiegelt daher keine Änderungen der Übertragbarkeit wider, ist aber dennoch sehr wertvoll für die Identifizierung der Art einer Telefonnummer. Sie kann Aufschluss darüber geben, ob eine Nummer ursprünglich als Mobilfunk-, Festnetz-, gebührenfreie, gebührenpflichtige oder virtuelle Nummer bezeichnet wurde - Kategorien, die häufig für die Betrugsbekämpfung, Kostenkontrolle und Nutzerqualifizierung relevant sind.

Die wichtigsten Vorteile sind:

  • Signale für Betrugsrisiken: Erkennen Sie virtuelle, Premium- oder Hochrisiko-Nummern, die auf eine Imitation oder künstlich aufgeblähten Datenverkehr hindeuten können.
  • Kosteneffizienz: Vermeiden Sie es, sich frühzeitig mit teuren oder ungültigen Numbers zu beschäftigen.
  • Qualität der Daten: Führen Sie eine Vorauswahl von Leads und Kundendatensätzen durch, indem Sie den Ursprung der Nummer verstehen.

Original Carrier ist ideal für Unternehmen, die ihre Kommunikation rationalisieren, künstlich aufgeblähten Datenverkehr reduzieren und ihre nummernbasierten Arbeitsabläufe mit leichter Intelligenz optimieren möchten.

Voraussetzungen

Um Identity Insights nutzen zu können, müssen Sie sicherstellen, dass Ihr Account korrekt konfiguriert ist; siehe die Erste Schritte Leitfaden für weitere Informationen über:

  • Erstellen Sie Ihren Account,
  • Erstellen einer Vonage-Anwendung zur Verwendung mit der Identity Insights API,
  • Die verschiedenen verfügbaren Umgebungen und wie Sie Ihren Account für deren Nutzung konfigurieren,
  • Und wie Sie die Dashboard-Einstiegs-UI verwenden, um die API zu nutzen, ohne Code zu schreiben.

In dieser Anleitung wird erklärt, wie man Original Carrier Insight programmatisch mit cURL verwendet.

Die Identity Insights API ist über mehrere regionale Endpunkte verfügbar. Die Beispiele in diesem Leitfaden verwenden den EU-Endpunkt, aber Sie finden die vollständige Liste unter Technische Details.

Einen API-Aufruf tätigen

Die Authentifizierung für die Identity Insights API erfolgt über JWTs, ein kompaktes und in sich geschlossenes JSON-Token. Um ein JWT zu generieren, können Sie unser Online-Generatoroder verwenden Sie alternativ die Vonage CLI. Sie benötigen Ihre Anwendungs-ID und Ihren privaten Schlüssel, um das JWT zu erzeugen. Sobald Sie Ihr JWT haben, können Sie eine Anfrage an die API senden.

Dieses Beispiel zeigt eine cURL-Anfrage für den Original Carrier insight:

curl -X POST https://api-eu.vonage.com/v0.1/identity-insights \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "original_carrier": {}
        }
    }'

Die API liefert dann Informationen über das Netz, dem die Telefonnummer derzeit zugewiesen ist, einschließlich des Namens, des Netztyps und der Landesvorwahl:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "original_carrier": {
        "name": "Orange Espana, S.A. Unipersonal",
        "network_type": "MOBILE",
        "country_code": "ES",
        "network_code": "21403",
        "status": {
        "code": "NO_COVERAGE",
        "message": "Success"
        }
    }
}

Sie sehen die folgenden Felder im Fenster original_carrier Array:

Feld Beschreibung
name Der vollständige Name des ursprünglichen Beförderers, der mit dem phone_number vorausgesetzt. Dies gilt nur für mobile Numbers.
network_type Die Art des Netzes, das phone_number ist verbunden mit. Wird einer von:

MOBILE: Eine Nummer, die einem mobilen Gerät zugewiesen ist, das normalerweise Sprachanrufe und Textnachrichten (SMS) senden und empfangen kann.
LANDLINE: Eine an einen Standort gebundene Festnetznummer, die hauptsächlich für Sprachanrufe verwendet wird und in der Regel keine SMS empfangen kann.
TOLLFREE: Eine Nummer, die es Anrufern ermöglicht, ein Unternehmen oder einen Dienst zu erreichen, ohne dass für den Anruf Gebühren anfallen; die Kosten trägt der Empfänger.
PREMIUM: Eine hochpreisige Nummer, die dem Anrufer zusätzliche Gebühren in Rechnung stellt. Sie wird häufig für spezielle Inhalte oder Dienste wie z. B. Wahltelefone oder Informationshotlines verwendet.
VIRTUAL: Eine cloudbasierte Nummer, die nicht an eine bestimmte SIM-Karte oder ein bestimmtes Gerät gebunden ist und häufig über Apps oder Online-Plattformen (z. B. Google Voice) verwaltet wird.
country_code Zweistelliger Ländercode für phone_number. Dies ist in ISO 3166-1 alpha-2 Format.
network_code Mobilfunk-Ländercodes (MCC) + Mobilfunknetzcodes (MNC). E.212 Internationale mobile Teilnehmeridentität.
status Gibt den Status der Informationen an, die für die angegebene Telefonnummer zurückgegeben werden.
code Code, der den Status der Anfrage angibt. Muss einer der folgenden sein:

NO_COVERAGE: Das Land oder das Mobilfunknetz wird von den verfügbaren Anbietern nicht unterstützt.
INVALID_PURPOSE: Der verwendete Zweck ist für diese Einsicht nicht gültig oder zulässig.
UNAUTHORIZED: Die Anfrage konnte für die Kombination aus Antrag, Lieferant und Telefonnummer nicht autorisiert werden.
INTERNAL_ERROR: Bei der Bearbeitung der Anfrage ist ein interner Fehler aufgetreten.
SUPPLIER_ERROR: Der Anbieter hat bei der Bearbeitung der Anfrage einen Fehler gemeldet.
NOT_FOUND: Die Rufnummer konnte für diese Einsicht nicht gefunden werden.
INVALID_NUMBER_FORMAT: Das Format der Telefonnummern ist für die Zuweisung durch die Netzbetreiber an die Benutzer nicht gültig.
PARTIAL_SUCCESS: Einige Antwortattribute wurden weggelassen, weil sie nicht anwendbar oder nicht verfügbar waren.
OK: Alle Insight-Attribute sind verfügbar und in der Antwort enthalten.
message Ausführlichere Statusbeschreibung.

Weitere Lektüre