Technische Details
Die Identity Insights API bietet eine einzige API für den Zugriff auf eine breite Palette von Attributen in Bezug auf den Betreiber, den Teilnehmer oder das Gerät, das mit einer Telefonnummer verbunden ist. Entwickler können einen einzigen Endpunkt nutzen, um verschiedene Attribute abzurufen, für die normalerweise mehrere Anbieter, CSPs und Integrationsmethoden erforderlich wären.
Die Attribute sind in Insights gruppiert, die jeweils einem bestimmten Feature-Set entsprechen. Die Verfügbarkeit kann je nach Region variieren. Der Entwickler gibt einfach an, welche Insight(s) in einer einzigen Anfrage abgerufen werden sollen.
Während einige Insights ohne vorherige Registrierung verfügbar sind, benötigen andere eine Genehmigung der Mobilfunkbetreiber. Die nachstehende Tabelle zeigt, welche Insights eine Genehmigung erfordern. Der Zugang zu diesen Insights wird über die "Network Registry" verwaltet. Um zu erfahren, wie Sie den Zugang beantragen können, folgen Sie dieser Leitfaden.
| Einsicht | Beschreibung | Genehmigung erforderlich? | Erfassungsbereich | Status |
|---|---|---|---|---|
| Format | Validierung des Formats einer Telefonnummer und Abruf von daraus abgeleiteten Informationen. | Nein | Weltweit | Beta |
| Original-Träger | Informationen über das Netz, das ursprünglich zugewiesen wurde. Informationen, die auf dem Präfix des Nummerierungsplans basieren. | Nein | Weltweit | Beta |
| Stromträger | Informationen über das Netz, dem die Nummer derzeit zugewiesen ist. | Nein | Weltweit | Beta |
| SIM-Wechsel | Informationen über einen kürzlich erfolgten Wechsel der SIM-Kopplung im Zusammenhang mit einem mobilen Account. | Anmeldung über Netzwerk-Register | Siehe Netzwerk-Funktionen | Beta |
| Standortüberprüfung | Verify, ob der Standort eines Endbenutzers innerhalb eines bestimmten Gebiets liegt. | Anmeldung über Netzwerk-Register | Siehe Netzwerk-Funktionen | Vorschau für Entwickler |
| Abonnenten-Match | Vergleichen Sie die Endnutzerdaten für eine Telefonnummer mit den bei einem Netzbetreiber gespeicherten Daten. | Anmeldung über Netzwerk-Register | Siehe Netzwerk-Funktionen | Vorschau für Entwickler |
| Roaming | Abrufen von Informationen über den Roaming-Status eines Geräts, einschließlich der Angabe, ob das Gerät Roaming betreibt und wenn ja, in welchem Land es Roaming betreibt. | Anmeldung über Netzwerk-Register | Siehe Netzwerk-Funktionen | Vorschau für Entwickler |
| Erreichbarkeit | Abrufen von Informationen über den Verbindungsstatus eines Geräts, einschließlich der Verfügbarkeit von Daten und SMS. | Anmeldung über Netzwerk-Register | Siehe Netzwerk-Funktionen | Vorschau für Entwickler |
Spielplatz
Verwenden Sie die Spielplatzeine sichere und kontrollierte Testumgebung, in der API-Aufrufe nur für eine kleine Gruppe von zugelassenen Telefonnummern Live-Daten zurückgeben, um die Identity Insights API sofort zu nutzen. Anders als bei der Produktion ist hier keine Genehmigung von Betreibern erforderlich.
Sie können auch den Zugriff auf die Virtueller Operatorein simulierter Operator, der gefälschte, aber deterministische Antworten für Virtual Numbers erzeugt.
API-Referenz
Die OpenAPI-Spezifikation für die Identity Insights API ist verfügbar hier.
Regionale Endpunkte
Für die Identity Insights-API sind mehrere Endpunkte verfügbar, die festlegen, wohin die API-Anfrage gesendet wird:
| Endpunkt | Region |
|---|---|
https://api-eu.vonage.com/v0.1/identity-insights | EU |
https://api-us.vonage.com/v0.1/identity-insights | US |
Erste Schritte
Auschecken Erste Schritte für eine Schritt-für-Schritt-Anleitung, wie Sie die Identity Insights API nutzen können.