Opérateur virtuel pour la connaissance de l'identité

L'opérateur virtuel fournit des réponses API prédéfinies et déterministes dans le cadre de l'application Registre du réseau lors de l'utilisation de numéros de téléphone associés à l'indicatif de pays non attribué +990. Il peut être utilisé comme opérateur simulé pour la découverte, le développement et le test des fonctionnalités du réseau dans des scénarios où l'accès à un opérateur réel n'est pas possible.

Pour utiliser l'opérateur virtuel, activez les fonctionnalités réseau dans votre application et sélectionnez le type « Test d'accès ». Tous les appels API destinés à des numéros de téléphone commençant par le +990 sera automatiquement redirigé vers l'opérateur virtuel.

Tous les appels API effectués à l'aide de l'opérateur virtuel doivent mettre en œuvre les mêmes flux d'authentification que ceux effectués par l'intermédiaire d'un opérateur mobile ordinaire.

L'opérateur virtuel est disponible par défaut pour toute application configurée pour les fonctionnalités réseau Vonage dans un Registre du réseau. Aucune configuration supplémentaire n'est nécessaire pour utiliser l'opérateur virtuel.

Il n'est pas nécessaire d'ajouter les Numbers commençant par +990 à votre liste blanche. Il vous suffit d'effectuer un appel API vers l'une des fonctionnalités du réseau Vonage prises en charge.

Réponses

Dix numéros de téléphone sont disponibles pour être testés avec l'opérateur virtuel : +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488et +990123499.

Les réponses aux demandes effectuées à l'aide de ces numéros de téléphone varient en fonction de l'insight utilisé ; ces réponses sont documentées ci-dessous.

Échange de cartes SIM

L'utilisation de n'importe lequel de ces numéros de téléphone donnera la même réponse : +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"
    }
}

Utilisation du numéro de téléphone +990123499 renvoie un numéro de téléphone inconnu :

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

L'utilisation de tout autre +990 renverra une erreur :

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

Correspondance des abonnés

Les réponses correspondantes sont renvoyées en fonction du numéro de téléphone fourni ; la demande peut contenir n'importe quel attribut, mais au moins un attribut pris en charge. Dans l'exemple suivant, l'utilisateur a demandé given_name, family_nameet birthdate:

Numéro de téléphone : +990123400

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

Numéro de téléphone : +990123411 ou +990123477

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

Numéro de téléphone : +990123422

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

Numéro de téléphone : +990123433

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

Numéro de téléphone : +990123444

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

Numéro de téléphone : +990123455, +990123466 ou +990123488

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

Numéro de téléphone : +990123499

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

Autre +990 Numbers

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

Vérification de l'emplacement

Les réponses sont déterminées par le numéro de téléphone fourni ; tous les autres champs peuvent être définis sur n'importe quelle valeur. Une explication de la signification de chaque résultat de vérification peut être trouvée dans la section Spécification API:

Numéro de téléphone : +990123400

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

Numéro de téléphone : +990123411

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

Numéro de téléphone : +990123422

{
    "is_verified": "UNKNOWN",
    "status": {
        "code": "OK",
        "message": "The insight was processed successfully."
      }
}

Numéro de téléphone : +990123433

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

Numéro de téléphone : +990123444

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

Numéro de téléphone : +990123455

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

Numéro de téléphone : +990123466

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

Numéro de téléphone : +990123477

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

Numéro de téléphone : +990123488

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

Numéro de téléphone : +990123499

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

Autre +990 Numbers

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

Format

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

L'utilisation de tout autre +990 renverra une erreur :

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

Transporteur original

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

L'utilisation de tout autre +990 renverra une erreur :

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

Transporteur actuel

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

L'utilisation de tout autre +990 renverra une erreur :

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

Accessibilité

Dans toutes les réponses, latest_status_at renvoie l'heure actuelle moins 2 minutes.

Numbers de téléphone : +990123400, +990123444 et +990123488 tout retour connecté avec les données et les SMS :

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

Numbers de téléphone : +990123411 ou +990123455 les deux retours sont liés à des données :

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

Numbers de téléphone : +990123422 ou +990123466 les deux reviennent connectés par SMS :

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

Numbers de téléphone : +990123433 ou +990123477 les deux reviennent non joignables :

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
    "is_reachable": false,
    "status": {
            "code": "OK",
            "message": "Success"
         }
    }
}

Numéro de téléphone : +990123499 renvoie le numéro de téléphone non trouvé :

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

L'utilisation de tout autre +990 renverra une erreur :

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

Itinérance

Dans toutes les réponses, latest_status_at renvoie l'heure actuelle moins 2 minutes.

Numéro de téléphone : +990123400 retours is_roaming est vrai, le code pays "GB":

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

Numéro de téléphone : +990123411 retours is_roaming est vrai, le code pays "DE":

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

Numéro de téléphone : +990123422 retours is_roaming est vrai, le code pays "US":

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

Numéro de téléphone : +990123433 retours is_roaming est vrai, avec plusieurs codes de pays :

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

Numéro de téléphone : +990123444 retours is_roaming est vrai, le code pays "BR":

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

Numéro de téléphone : +990123455 retours is_roaming est vrai, mais sans code pays :

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

Numéro de téléphone : +990123466 retours is_roaming est vrai, mais aucun code de pays n'a pu être identifié :

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

Numbers de téléphone : +990123477 et +990123488 les deux reviennent is_roaming comme faux :

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": false,
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

Numéro de téléphone : +990123499 renvoie le numéro de téléphone non trouvé :

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

L'utilisation de tout autre +990 renverra une erreur :

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

Échange d'appareils

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

Utilisation du numéro de téléphone +990123499 renvoie un numéro de téléphone inconnu :

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

L'utilisation de tout autre +990 renverra une erreur :

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

Ancienneté de l'abonné

L'utilisation de différents numéros de téléphone virtuels donnera lieu à des réponses différentes, comme illustré ci-dessous.

Numbers de téléphone : +990123400, +990123411, +990123422

{
"is_tenure_met": true, // false if date is >180 days ago
    "contract_type": "PREPAID",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Numbers de téléphone : +990123433, +990123444, +990123455

{    
    "is_tenure_met": true, // false if date is >180 days ago
    "contract_type": "POSTPAID",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Téléphones : +990123466, +990123477

{    
    "is_tenure_met": true, // false if date is >180 days ago
    "contract_type": "BUSINESS",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Numéro de téléphone : +990123488

{    
    "is_tenure_met": true, // or false based on L3
    "status": {
        "code": "SUCCESS",
        "message": "Unable to retrieve data for some fields"
    }
}

Utilisation du numéro de téléphone +990123499 renvoie un numéro de téléphone inconnu :

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

L'utilisation de tout autre +990 renverra une erreur :

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

Vérification de l'âge

À cet égard, les réponses varient en fonction du numéro de téléphone utilisé.

Numbers de téléphone : +990123400, +990123411

{    
    "is_age_threshold_met": "TRUE", // age=12
    "is_verified": true,
    "identity_match_score": 100,
    "content_lock": "TRUE",
    "parental_control": "TRUE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Numbers de téléphone : +990123422, +990123433

{    
    "is_age_threshold_met": "TRUE", // age=23
    "is_verified": true,
    "identity_match_score": 70,
    "content_lock": "FALSE",
    "parental_control": "FALSE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Numbers de téléphone : +990123444, +990123455

{    
    "is_age_threshold_met": "TRUE", // age=37
    "is_verified": false,
    "identity_match_score": 50,
    "content_lock": "TRUE",
    "parental_control": "TRUE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Numbers de téléphone : +990123466

{    
    "is_age_threshold_met": "TRUE", // age=15
    "is_verified": false,
    "identity_match_score": 30,
    "content_lock": "TRUE",
    "parental_control": "TRUE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Numbers de téléphone : +990123477

{
    "is_age_threshold_met": "DATA_UNAVAILABLE",
    "status": { 
        "code": "OK", 
        "message": "Success" 
    } 
}

Numbers de téléphone : +990123488

{    
    "is_age_threshold_met": "TRUE", // age=20
    "is_verified": false,
    "identity_match_score": 0,
    "content_lock": "TRUE",
    "parental_control": "TRUE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

Utilisation du numéro de téléphone +990123499 renvoie un numéro de téléphone inconnu :

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

L'utilisation de tout autre +990 renverra une erreur :

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

Recyclage des numéros

La réponse de l'opérateur virtuel variera en fonction du numéro de téléphone fourni :

Numbers de téléphone : +990123400, +990123411, +990123422

{
	"is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 1 day
      "status": {
          "code": "OK",
          "message": "Success"
      }
}

Numbers de téléphone : +990123433, +990123444, +990123455

{    
  	"is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 7 days
     "status": {
          "code": "OK",
          "message": "Success"
      }
}

Numéro de téléphone : +990123466

{    
     "is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 30 days
     "status": {
         "code": "OK",
         "message": "Success"
      }
}

Numéro de téléphone : +990123477

{    
"is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 90 days
     "status": {
         "code": "OK",
         "message": "Success"
      }
}

Numéro de téléphone : +990123488

{    
  	"is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 180 days
     "status": {
         "code": "OK",
         "message": "Success"
      }
}

Utilisation du numéro de téléphone +990123499 renvoie un numéro de téléphone inconnu :

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

L'utilisation de tout autre +990 renverra une erreur :

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