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.
Mit Wirkung vom 4. Februar 2027 wird Vonage Number Insights auslaufen. Um einen unterbrechungsfreien Support zu gewährleisten und eine besser skalierbare und zukunftssichere Lösung anzubieten, empfehlen wir Ihnen, auf unser erweitertes Angebot zu migrieren: Vonage Einblicke in die Identität API. Die Vonage Identity Insights API konsolidiert mehrere telefonnummernbezogene Datensätze in einer einzigen, flexiblen API, die es Ihnen ermöglicht, Echtzeitinformationen zu einer Telefonnummer anzufordern und eine beliebige Kombination von Einblicken - wie z. B. Nummernformatierung, Betreiberdetails, SIM-Swap und Subscriber Match - mit einem einzigen Aufruf abzurufen.
Bitte prüfen Sie die Numbers Einblicke - Leitfaden für den Übergangdie detaillierte Anleitungen zu API-Unterschieden, erforderlichen Änderungen und bewährten Verfahren für einen reibungslosen Übergang enthält.
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 |
|---|---|---|---|
| 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* | |||
| Roaming-Status* | |||
| Roaminganbieter und Land* | |||
| CNAM (Zusatzmodul) |
* 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: