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 Terrain de jeu du 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, il suffit de sélectionner "Playground" dans la configuration de votre application. Tous les appels API dirigés vers des numéros de téléphone dotés de l'attribut +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 dans une application Terrain de jeux Le mode de fonctionnement de l'Opérateur Virtuel est le même que celui de l'Opérateur Virtuel. Aucune autre configuration n'est nécessaire pour utiliser l'opérateur virtuel.
Il n'est pas nécessaire d'ajouter les numéros +990 à votre liste d'autorisation. Il suffit de passer un appel API à l'une des fonctions réseau 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
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, +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"
}
}
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
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, +990123499
{
"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
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, +990123499
{
"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é
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.
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
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.
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."
}
}