Number Insight API Technische Details
Die Number Insight API von Vonage bietet Echtzeit-Einblicke in Telefonnummern und hilft Ihnen zu verstehen, mit wem Sie verbunden sind. Verifizieren Sie sofort, ob es sich bei einer Number um eine Mobil- oder Festnetznummer handelt, identifizieren Sie das mit Mobilnummern verbundene Netz, überprüfen Sie, ob die Nummer korrekt formatiert ist, und erkennen Sie potenzielle Betrugssignale.
Numbers Insight Merkmale
Die Funktionen der Number Insight API sind auf mehrere Pläne oder Endpunkte verteilt, je nachdem, welche Art von Informationen Sie benötigen.
Betreiberinformationen sind in den Tarifen Basic, Standard und Advanced verfügbar, wobei jeder Endpunkt auf den Fähigkeiten des vorherigen aufbaut. Der Standard-Endpunkt enthält beispielsweise alle Gebietsschema- und Formatierungsdaten des Basis-Endpunkts sowie zusätzliche Details wie die Art der Nummer, den aktuellen Anbieter (wenn es sich um eine Mobilfunknummer handelt) und die Identität des Anrufers (nur USA). Der erweiterte Endpunkt bietet die umfangreichsten Daten, einschließlich aller Daten des Basis- und des Standard-Endpunkts, sowie Roaming- und Erreichbarkeitsinformationen.
Der Betrugserkennungsplan (BETA) hingegen kombiniert die Messwerte aus den vorgenannten Plänen mit zusätzlichen Datenquellen, um zu beurteilen, ob eine Nummer wahrscheinlich betrügerisch ist, z. B. in Fällen von kürzlich erfolgten SIM-Wechseln.
Vergleich der Merkmale
| Merkmal | Grundlegend | Standard | Fortgeschrittene | Aufdeckung von Betrug |
|---|---|---|---|---|
| Format und Herkunft der Numbers | ||||
| Länderinformationen (Ländercode, Name, Vorwahl) | ||||
| Aktueller Netzbetreiber (Netzcode, Name, Land, Netztyp) | ||||
| Ursprünglicher Netzbetreiber (Netzcode, Name, Land, Netztyp) | ||||
| Informationen zur Portierung | ||||
| Gültigkeit* | ||||
| Erreichbarkeit* | ||||
| Echtzeitdaten (aktiver Status, Handset-Status) (Auslaufen am 1. Oktober 2025) | ||||
| Roaming-Status* | ||||
| Roaminganbieter und Land* | ||||
| CNAM (Zusatzmodul) | ||||
| SIM-Swap* (Wird am 23. November 2025 eingestellt und ist danach nicht mehr verfügbar. Um SIM Swap zu erkennen, migrieren Sie bitte zum Einblicke in die Identität API.) |
* Nur in bestimmten Märkten verfügbar. Bitte testen Sie und/oder kontaktieren Sie den Vertrieb für weitere Informationen.
Überprüfen Sie die Gesetzgebung in Ihrem Land, um sicherzustellen, dass Sie Benutzer-Roaming-Informationen speichern dürfen.
Erste Schritte
Dieses Beispiel zeigt Ihnen, wie Sie die Vonage CLI um auf die Number Insight Basic API zuzugreifen und Informationen über eine Nummer anzuzeigen.
Beispiele für die Verwendung von Basic, Standard und Advanced Numbers Insight mit curl und die Entwickler-SDKs sehen die Code-Schnipsel.
Bevor Sie beginnen:
- Registrieren Sie sich für eine Vonage API-Konto
- Installieren Sie Node.JS
Installieren und Einrichten der Vonage CLI
$ npm install --location=global @vonage/cli
Hinweis: Abhängig von Ihren Benutzerrechten müssen Sie dem obigen Befehl möglicherweise das Wort sudo.
Verwenden Sie Ihr VONAGE_API_KEY und VONAGE_API_SECRET von der Dashboard Einstiegsseite um die Vonage CLI mit Ihren Anmeldedaten einzurichten:
Ausführen eines Number Insight API Basic Lookups
Führen Sie den unten gezeigten Beispielbefehl aus und ersetzen Sie dabei die Telefonnummer durch eine, über die Sie Informationen wünschen: