Roaming

Verwenden Sie den Roaming Insight der Vonage Identity Insights API, um den Roaming-Status und das Land für ein bestimmtes Gerät in einem Mobilfunknetz zu überprüfen. Sie kann feststellen, in welchem Land das Gerät roamt, zusammen mit einem Zeitstempel der letzten Sendezeit.

Einige Anwendungsfälle, in denen diese Informationen nützlich sein können, sind:

  • Identifizierung von Betrug: Verringerung des Betrugsrisikos ohne zusätzliche Reibungsverluste für den Nutzer. Ein Beispiel: Eine große Transaktion wird aus einem Land angefordert, das nicht mit dem Roaming-Status des Kontoinhabers übereinstimmt. Die Diskrepanz zwischen dem von der Bank identifizierten Land und dem über Roaming ermittelten Land führt dazu, dass die Bank die Transaktion sperrt.
  • Einhaltung von Vorschriften: Durchsetzung der Einhaltung gesetzlicher Vorschriften und territorialer Beschränkungen auf der Grundlage des Standorts des Mobilfunknetzes des Benutzers, z. B. Beschränkungen der Inhaltslizenz für das Videostreaming in bestimmten Ländern.
  • Personalisierung der Dienstleistungen: Nahtlose Personalisierung von Diensten und Werbung entsprechend dem Standort des Nutzers.

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 Roaming 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 Roaming-Einblick, um zu prüfen, ob ein bestimmtes Gerät Roaming betreibt, und wenn ja, in welchem Land dieses Gerät Roaming betreibt:

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

Die API gibt dann Roaming-Informationen für dieses Gerät zurück - wenn es Roaming betreibt und das Land, in dem es Roaming betreibt, identifiziert werden kann, wird dieses Land mit der Option country_codes Feld:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "country_codes": ["DE"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
  }
}

Sie sehen die folgenden Felder im Fenster roaming Array:

Feld Beschreibung
latest_status_at Letzter Zeitpunkt der Aktualisierung des zugehörigen Roaming-Status.
is_roaming Roaming-Status - wird sein true wenn Roaming.
country_codes Zweistelliger Ländercode für das Land (oder die Länder), das/die phone_number Roaming ist. Das Array enthält in der Regel ein Element, aber in Grenzfällen, in denen das Roamingnetz mit mehreren Ländern verbunden ist, werden zusätzliche Ländercodes aufgenommen. Dies ist in ISO 3166-1 alpha-2 Format.
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