Abonnenten-Match

Subscriber Match vergleicht die Endnutzerdaten für eine Telefonnummer mit den Daten, die bei ihrem Mobilfunkbetreiber gespeichert sind. Die Informationen können den Namen, die Adresse, die Postleitzahl, die Telefonnummer und das Geburtsdatum des Nutzers umfassen. Subscriber Match gibt für jedes Attribut eine Antwort auf die Übereinstimmung zurück - es werden keine personenbezogenen Daten (PII) zurückgegeben. Dieser Einblick kann mit allen anderen Informationen kombiniert werden. Einblicke in der API verfügbar.

Subscriber Match ermöglicht Ihnen das:

  • Verifizieren Sie echte Benutzer schneller, reduzieren Sie die Abwanderung und verbessern Sie das Kundenerlebnis.
  • Erhöhung der Konversionsrate von Kundenanmeldungen
  • Reduzieren Sie das Risiko von Identitätsdiebstahl und synthetischem Identitätsbetrug für Ihr Unternehmen
  • Besseres Wissen über Ihre Kunden (KYC) zur Einhaltung der Vorschriften in Ihrem Markt
  • Kombinieren Sie Subscriber Match nahtlos mit anderen Insights, wie SIM Swap oder Location Verification, um Risiken zu erkennen und Online-Transaktionen zu sichern.

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 den Subscriber Match 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 Subscriber Match Insight zum Vergleich der Felder in der subscriber_matchSie können so viele oder so wenige Attribute in das Array aufnehmen, wie Sie möchten:

curl -X POST https://api-eu.vonage.com/v0.1/identity-insights \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "3932462384260",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
        "subscriber_match": {
            "id_document": "66666666q",
            "given_name": "Federica",
            "family_name": "Sanchez Arjona",
            "street_name": "Crawfords Corner Road",
            "street_number": "4",
            "postal_code": "07733",
            "locality": "Holmdel",
            "region": "Monmouth County",
            "country": "US",
            "house_number_extension": "Suite 2416",
            "birthdate": "1978-08-22"
          }
        }
    }'

Die API vergleicht dann die mit dem jeweiligen Mobiltelefonbenutzer verknüpften Informationen mit den gespeicherten (und überprüften) Informationen aus den Aufzeichnungen des Mobiltelefonbetreibers und gibt für jedes angegebene Attribut einen Übereinstimmungswert zurück:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "subscriber_match": {
        "id_document_match": "EXACT",
        "given_name_match": "DATA_UNAVAILABLE",
        "family_name_match": "DATA_UNAVAILABLE",
        "address_match": "EXACT",
        "street_name_match": "EXACT",
        "street_number_match": "EXACT",
        "postal_code_match": "EXACT",
        "country_match": "EXACT",
        "birthdate_match": "NONE",
        "status": {
            "code": "PARTIAL_SUCCESS",
            "message": "Unable to retrieve data for some fields."
      }
    }
  }
}

Jedes Feld innerhalb der subscriber_match Array hat einen der folgenden Werte:

  • EXACT - der angegebene Wert genau übereinstimmt.
  • HIGH - der angegebene Wert ist eine enge, aber unvollkommene Übereinstimmung.
  • PARTIAL - der angegebene Wert stimmt teilweise überein.
  • LOW- der angegebene Wert stimmt nur geringfügig überein.
  • NONE - der angegebene Wert stimmt überhaupt nicht überein.
  • DATA_UNAVAILABLE - keine Daten für das Attribut "Anfrage" vorhanden sind.

Außerdem gibt es eine status Array, das das Ergebnis der Anfrage anzeigt:

  • code - wird einer der folgenden Werte sein:
    • UNAUTHORIZED - es gibt ein Problem mit der Authentifizierung für die Anfrage.
    • INVALID_PURPOSE - der im Antrag angegebene Zweck nicht gültig ist.
    • INVALID_NUMBER_FORMAT - das Format der Rufnummer ist ungültig.
    • NOT_FOUND - die angegebene Rufnummer kann vom Betreiber nicht gefunden werden.
    • NO_COVERAGE - die API in dem Land, in dem sich der Nutzer befindet, nicht abgedeckt ist.
    • INTERNAL_ERROR- die API hat einen Fehler zurückgegeben.
    • SUPPLIER_ERROR - es gibt ein Problem mit einem der angegebenen Attribute. Ausführlichere Informationen finden Sie in der message Feld.
    • PARTIAL_SUCCESS - ein oder mehrere Attribute zurückgegeben hat DATA_UNAVAILABLE.
    • OK - alle Attribute eine übereinstimmende Antwort geliefert haben.
    • SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED - Operator erfordert idDocument, um mit allen anderen Attributen übereinzustimmen.
    • SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH - Operator kann nicht mit idDocument übereinstimmen, das für die Übereinstimmung mit anderen Attributen erforderlich ist.
    • SUBSCRIBER_MATCH.INVALID_PARAM_COMBINATION - angegebene Parameterkombination ist ungültig.
  • message - enthält eine ausführlichere Statusbeschreibung.

Weitere Lektüre