Virtueller Operator

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.

Der Virtual Operator liefert deterministische API-Antworten auf der Grundlage bestimmter Parameter in der API-Anforderung.

Abruf des Gerätestandorts

Die Antworten werden durch die nachgestellten Ziffern der angegebenen Telefonnummer bestimmt; alle anderen Felder können auf einen beliebigen Wert gesetzt werden. In allen Antworten wird die lastLocationTime wird die aktuelle Uhrzeit angezeigt:

Telefon-Nummer Antwort
Die letzten beiden Ziffern sind "11", z. B. "+9902345611". Erhalten Sie eine circle Antwort.
"latitude": "50.707815"
"longitude": "7.128740"
"radius": 200
Die letzten beiden Ziffern sind "22", z. B. "+9902345622". Erhalten Sie eine circle Antwort.
"latitude": "50.722112"
"longitude": "7.113625"
"radius": 200
Die letzten beiden Ziffern sind "33", z. B. "+9902345633". Erhalten Sie eine circle Antwort.
"latitude": "50.737057"
"longitude": "7.101254"
"radius": 200
Die letzten beiden Ziffern sind "44", z. B. "+9902345644". Erhalten Sie eine circle Antwort.
"latitude": "50.724535"
"longitude": "7.093150"
"radius": 200
Die letzten beiden Ziffern sind "55", z. B. "+9902345655". Erhalten Sie eine circle Antwort.
"latitude": "50.701605"
"longitude": "7.103051"
"radius": 200
Die letzten beiden Ziffern sind "66", z. B. "+9902345666". Erhalten Sie eine polygon Antwort.
{"latitude": 50.732896, "longitude": 7.102896},
{"latitude": 50.731849, "longitude": 7.104989 },
{"latitude": 50.732545, "longitude": 7.105906},
{"latitude": 50.733659, "longitude": 7.103809}
Die letzten beiden Ziffern sind "77", z. B. "+9902345677". Erhalten Sie eine circle Antwort.
"latitude": "28.425600"
"longitude": "-81.468880"
"radius": 200
Die letzten beiden Ziffern sind "88", z. B. "+9902345688". Erhalten Sie eine circle Antwort.
"latitude": "39.013607"
"longitude": "-94.537209"
"radius": 200
Die letzten beiden Ziffern sind "99", z. B. "+9902345699". Bedienerfehler:
"status": 400
"code": "INVALID_INPUT"
"message": "Virtual Operator predefined error for numbers ending with 99."

Einblicke in die Identität

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

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

{
      "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

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

{
      "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

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.

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

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.

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."
    }
}

Verify - Stille Authentifizierung

Der Virtuelle Operator gibt immer eine Antwort zurück, die die check_url für das Ereignis "Stille Authentifizierung" für eine beliebige angeforderte Nummer (beginnend mit +990). Das Ergebnis hängt von den letzten Ziffern der Nummer ab, wie unten dargestellt:

Telefon (zum Feld) Ergebnis
Numbers, die mit einer geraden Ziffer enden, z. B. +9902345602 completed - erfolgreiche Prüfung, und der Benutzer wurde authentifiziert.
Numbers, die mit einer ungeraden Ziffer enden, z. B. +9902345601 user_rejected - erfolgreiche Prüfung, aber der Benutzer wurde nicht authentifiziert.
Numbers, die mit 99 enden, z. B. +9902345699. failed - nicht in der Lage, die Prüfung abzuschließen.

QoD

Antworten an den Virtuellen Operator sind immer erfolgreich, Beispiele für Antworten und Rückrufe finden Sie in der QoD Webhooks Anleitung.