Virtueller Operator für Identity Insights

Der Virtual Operator bietet vordefinierte und deterministische API-Antworten innerhalb der Netzwerk Registry Playground bei der Verwendung von Telefonnummern, die mit einer nicht zugewiesenen Landesvorwahl verbunden sind +990. Es kann als simulierter Operator für die Erkennung, Entwicklung und Prüfung von Netzwerkfunktionen in Szenarien verwendet werden, in denen kein Zugang zu einem Live-Operator möglich ist.

Um den Virtual Operator zu nutzen, wählen Sie in der Konfiguration Ihrer Anwendung einfach "Playground" aus. Alle API-Anrufe, die an Telefonnummern mit der Option +990 Vorwahl wird automatisch an den virtuellen Betreiber weitergeleitet.

Für alle API-Aufrufe, die über den virtuellen Betreiber getätigt werden, müssen dieselben Authentifizierungsabläufe implementiert werden wie für die über einen regulären Mobilfunkbetreiber getätigten.

Der virtuelle Operator ist standardmäßig für jede Anwendung verfügbar, die für Netzwerkfunktionen in einer Spielplatz Modus. Für die Verwendung des virtuellen Bedieners ist keine weitere Konfiguration erforderlich.

Es ist nicht notwendig, +990 Numbers zu Ihrer Erlaubnisliste hinzuzufügen. Machen Sie einfach einen API-Aufruf zu einer der unterstützten Netzwerkfunktionen.

Antworten

Es stehen 10 Telefonnummern zum Testen mit dem Virtual Operator zur Verfügung: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488und +990123499.

Die Antworten auf Anfragen, die diese Telefonnummern verwenden, variieren je nach der von Ihnen verwendeten Einsicht; diese Antworten sind unten dokumentiert.

SIM-Wechsel

Sie erhalten die gleiche Antwort, wenn Sie eine dieser Nummern wählen: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488

{
    "latest_sim_swap_at": "2017-11-14T01:07:28Z", // 500 hours ago
    "is_swapped": false, // true if period < 500 hours, false if period > 500 hours
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Verwendung der Rufnummer +990123499 wird eine unbekannte Telefonnummer zurückgeben:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "Unknown phone number."
    }
}

Mit jeder anderen +990 Nummer führt zu einem Fehler:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499. For further information refer to https://developer.vonage.com/en/getting-started-network/concepts/virtual-operator."
    }
}

Abonnenten-Match

Übereinstimmende Antworten werden entsprechend der angegebenen Telefonnummer zurückgegeben; die Anfrage kann jedes, aber mindestens ein unterstütztes Attribut enthalten. Im folgenden Beispiel forderte der Benutzer given_name, family_nameund birthdate:

Telefonnummer: +990123400

{
    "given_name_match": "DATA_UNAVAILABLE",
    "family_name_match": "DATA_UNAVAILABLE",
    "birthdate_match": "DATA_UNAVAILABLE",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

Telefonnummer: +990123411 oder +990123477

{
    "given_name_match": "EXACT",
    "family_name_match": "EXACT",
    "birthdate_match": "EXACT",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

Telefonnummer: +990123422

{
    "given_name_match": "HIGH",
    "family_name_match": "HIGH",
    "birthdate_match": "HIGH",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

Telefonnummer: +990123433

{
    "given_name_match": "PARTIAL",
    "family_name_match": "PARTIAL",
    "birthdate_match": "PARTIAL",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

Telefonnummer: +990123444

{
    "given_name_match": "LOW",
    "family_name_match": "LOW",
    "birthdate_match": "LOW",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

Telefonnummer: +990123455, +990123466 oder +990123488

{
    "given_name_match": "NONE",
    "family_name_match": "NONE",
    "birthdate_match": "NONE",
        "status": {
        "code": "OK",
    "message": "Success."
    }
}

Telefonnummer: +990123499

{
    "status": {
        "code": "NOT_FOUND",
        "message": "Unknown phone number."
    }
}

Jede andere +990 Number

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499. For further information refer to https://developer.vonage.com/en/getting-started-network/concepts/virtual-operator."
    }
}

Standortüberprüfung

Die Antworten werden durch die angegebene Telefonnummer bestimmt; alle anderen Felder können auf einen beliebigen Wert gesetzt werden. Eine Erklärung, was die einzelnen Überprüfungsergebnisse bedeuten, finden Sie in der API-Spezifikation:

Telefonnummer: +990123400

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "TRUE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

Telefonnummer: +990123411

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "PARTIAL",
    "match_rate": 50,
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

Telefonnummer: +990123422

{
    "is_verified": "UNKNOWN",
    "status": {
    "code": "PARTIAL_SUCCESS",
    "message": "Unable to retrieve data for some fields"
    }
}

Telefonnummer: +990123433

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "FALSE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

Telefonnummer: +990123444

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "TRUE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

Telefonnummer: +990123455

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "FALSE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

Telefonnummer: +990123466

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "TRUE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

Telefonnummer: +990123477

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "FALSE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

Telefonnummer: +990123488

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "TRUE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

Telefonnummer: +990123499

{
    "status": {
    "code": "NOT_FOUND",
    "message": "Unknown phone number."
    }
}

Jede andere +990 Number

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499. For further information refer to https://developer.vonage.com/en/getting-started-network/concepts/virtual-operator."
    }
}

Format

Sie erhalten die gleiche Antwort, wenn Sie eine dieser Nummern wählen: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488, +990123499

{
    "country_code": "XX",
    "country_name": "Virtual",
    "country_prefix": "990",
    "offline_location": "Virtual",
    "time_zones": ["UTC"],
    "number_international": "+990123411",
    "number_national": "123411",
    "is_valid_format": true,
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Mit jeder anderen +990 Nummer führt zu einem Fehler:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499. For further information refer to https://developer.vonage.com/en/getting-started-network/concepts/virtual-operator."
    }
}

Original-Träger

{
      "name": "Virtual CSP",
      "network_type": "MOBILE",
      "country_code": "XX",
      "network_code": "00101",
      "status": {
            "code": "OK",
            "message": "Success"
      }
}

Mit jeder anderen +990 Nummer führt zu einem Fehler:

{
      "status": {
            "code": "INVALID_NUMBER_FORMAT",
            "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499. For further information refer to https://developer.vonage.com/en/getting-started-network/concepts/virtual-operator."
      }
}

Stromträger

{
      "name": "Virtual CSP",
      "network_type": "MOBILE",
      "country_code": "XX",
      "network_code": "00101",
      "status": {
            "code": "OK",
            "message": "Success"
      }
}

Mit jeder anderen +990 Nummer führt zu einem Fehler:

{
      "status": {
            "code": "INVALID_NUMBER_FORMAT",
            "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499. For further information refer to https://developer.vonage.com/en/getting-started-network/concepts/virtual-operator."
      }
}

Erreichbarkeit

In allen Antworten, latest_status_at gibt die aktuelle Zeit minus 2 Minuten zurück.

Telefonnummern: +990123400, +990123444 und +990123488 alle Rückgaben verbunden mit Daten und SMS:

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z",
    "is_reachable": true,
    "connectivity": ["DATA","SMS"],
    "status": {
            "code": "OK",
            "message": "Success"
         }
    }
}

Telefonnummern: +990123411 oder +990123455 beide kehren mit Daten verbunden zurück:

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z",
    "is_reachable": true,
    "connectivity": ["DATA"],
    "status": {
            "code": "OK",
            "message": "Success"
         }
    }
}

Telefonnummern: +990123422 oder +990123466 beide kehren verbunden mit SMS zurück:

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z",
    "is_reachable": true,
    "connectivity": ["SMS"],
    "status": {
            "code": "OK",
            "message": "Success"
         }
    }
}

Telefonnummern: +990123433 oder +990123477 beide sind nicht erreichbar:

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z",
    "is_reachable": false,
    "status": {
            "code": "PARTIAL_SUCCESS",
            "message": "Some response attributes were omitted because they are not applicable or were not available."
         }
    }
}

Telefonnummer: +990123499 gibt die nicht gefundene Telefonnummer zurück:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "The phone number could not be found for this Insight"
    }
}

Mit jeder anderen +990 Nummer führt zu einem Fehler:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499. For further information refer to https://developer.vonage.com/en/getting-started-network/concepts/virtual-operator."
    }
}

Roaming

In allen Antworten, latest_status_at gibt die aktuelle Zeit minus 2 Minuten zurück.

Telefonnummer: +990123400 gibt zurück. is_roaming wahr ist, wird der Ländercode "GB":

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "country_codes": ["GB"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

Telefonnummer: +990123411 gibt zurück. is_roaming wahr ist, wird der Ländercode "DE":

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "country_codes": ["DE"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

Telefonnummer: +990123422 gibt zurück. is_roaming wahr ist, wird der Ländercode "US":

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "country_codes": ["US"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

Telefonnummer: +990123433 gibt zurück. is_roaming wahr ist, mit mehreren Ländercodes:

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "country_codes": ["BL,GF,GP,MF,MQ"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

Telefonnummer: +990123444 gibt zurück. is_roaming wahr ist, wird der Ländercode "BR":

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "country_codes": ["BR"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

Telefonnummer: +990123455 gibt zurück. is_roaming ist richtig, aber ohne Landesvorwahl:

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "status": {
            "code": "PARTIAL_SUCCESS",
            "message": "Some response attributes were omitted because they are not applicable or were not available."
        }
    }
}

Telefonnummer: +990123466 gibt zurück. is_roaming ist richtig, aber es konnte kein Ländercode ermittelt werden:

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "status": {
            "code": "PARTIAL_SUCCESS",
            "message": "Some response attributes were omitted because they are not applicable or were not available."
        }
    }
}

Telefonnummern: +990123477 und +990123488 beide kehren zurück is_roaming als falsch:

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": false,
        "status": {
            "code": "PARTIAL_SUCCESS",
            "message": "Some response attributes were omitted because they are not applicable or were not available."
        }
    }
}

Telefonnummer: +990123499 gibt die nicht gefundene Telefonnummer zurück:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "The phone number could not be found for this Insight"
    }
}

Mit jeder anderen +990 Nummer führt zu einem Fehler:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499. For further information refer to https://developer.vonage.com/en/getting-started-network/concepts/virtual-operator."
    }
}