Abrufen von CNAM-Eigentümerdaten

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.

Übersicht

Mit der Number Insight Advanced API von Vonage können Sie CNAM-Inhaberdetails für viele Telefonnummern in den USA abrufen. Dazu gehören Festnetz- und Handynummern sowohl für Privatpersonen als auch für Unternehmen.

CNAM ist ein Akronym und steht für Caller ID Name. In den US-Netzen wird damit der Name des Anrufers neben der Telefonnummer angezeigt, damit die Nutzer den Anrufer identifizieren können.

Die Number Insight Advanced API liefert nur CNAM-Details für US-Nummern: Sie kann diese Informationen nicht für Nummern in anderen Ländern zurückgeben.

Den Antrag stellen

Weitergabe cnam=true als zusätzlicher Parameter in einem Aufruf an die erweiterte API wird das CNAM dieser Nummer nachgeschlagen.

Das folgende Beispiel zeigt, wie Sie CNAM-Daten abfragen würden curl:

curl "https://api.nexmo.com/ni/advanced/json?api_key=VONAGE_API_KEY&api_secret=VONAGE_API_SECRET&number=14155550100&cnam=true"

Die Reaktion verstehen

In der Antwort, die von der Number Insight Advanced API zurückgegeben wird, beziehen sich die folgenden Felder auf CNAM:

  • caller_nameden Namen des Eigentümers
  • caller_type: entweder business oder consumer abhängig von der Art der Numbers
  • first_name und last_name: nur für Consumer Numbers

Beispiel für Verbraucher

{
    "status": 0,
    "status_message": "Success",
    "lookup_outcome": 1,
    "lookup_outcome_message": "Partial success - some fields populated",
    "request_id": "50793c0c-8025-408f-ab9a-71cbbaf033bf",
    "international_format_number": "14155550100",
    "national_format_number": "(415) 55500100",
    "country_code": "US",
    "country_code_iso3": "USA",
    "country_name": "United States of America",
    "country_prefix": "1",
    "request_price": "0.04000000",
    "remaining_balance": "10.000000",
    "current_carrier": {
        "network_code": "310004",
        "name": "Verizon Wireless",
        "country": "US",
        "network_type": "mobile"
    },
    "original_carrier": {
        "network_code": "310004",
        "name": "Verizon Wireless",
        "country": "US",
        "network_type": "mobile"
    },
    "valid_number": "valid",
    "reachable": "unknown",
    "ported": "not_ported",
    "roaming": {"status": "unknown"},
    "ip_warnings": "unknown",
    "caller_name": "Wile E. Coyote",
    "last_name": "Coyote",
    "first_name": "Wile",
    "caller_type": "consumer"
}

Geschäftliches Beispiel

{
    "status": 0,
    "status_message": "Success",
    "lookup_outcome": 1,
    "lookup_outcome_message": "Partial success - some fields populated",
    "request_id": "27c61a46-5b4a-4e80-b16d-725432559078",
    "international_format_number": "14155550101",
    "national_format_number": "(415) 555-0101",
    "country_code": "US",
    "country_code_iso3": "USA",
    "country_name": "United States of America",
    "country_prefix": "1",
    "request_price": "0.04000000",
    "remaining_balance": "10.000000",
    "current_carrier": {
        "network_code": "US-FIXED",
        "name": "United States of America Landline",
        "country": "US",
        "network_type": "landline"
    },
    "original_carrier": {
        "network_code": "US-FIXED",
        "name": "United States of America Landline",
        "country": "US",
        "network_type": "landline"
    },
    "valid_number": "valid",
    "reachable": "unknown",
    "ported": "not_ported",
    "roaming": {"status": "unknown"},
    "ip_warnings": "unknown",
    "caller_name": "ACME Corporation",
    "caller_type": "business"
}