Itinérance

Utilisez la fonction Roaming Insight de l'API Identity Insights de Vonage pour vérifier l'état d'itinérance et le pays d'un appareil donné sur un réseau mobile. Il peut identifier le pays dans lequel l'appareil est en itinérance, ainsi que l'horodatage de la dernière heure diffusée.

Voici quelques cas d'utilisation où ces informations peuvent être utiles :

• Identification des fraudes : Diminuer le risque de fraude sans friction supplémentaire pour l'utilisateur. Par exemple, une transaction importante est demandée depuis un pays qui ne correspond pas au statut d'itinérance du titulaire du compte. La non-concordance entre le pays identifié par la banque et celui détecté par l'itinérance conduit la banque à bloquer la transaction.
• Conformité réglementaire : Appliquer la conformité réglementaire et les restrictions territoriales en fonction de l'emplacement du réseau cellulaire de l'utilisateur, telles que les restrictions de licence de contenu pour la diffusion vidéo dans certains pays.
• Personnalisation des services : Fournir une personnalisation transparente des services et des publicités en fonction de la localisation de l'utilisateur.

Conditions préalables

Pour utiliser Identity Insights, vous devez vous assurer que votre Account est correctement configuré. Pour commencer pour plus d'informations :

• Création de votre Account,
• Création d'une application Vonage à utiliser avec l'API Identity Insights,
• Les différents environnements disponibles et comment configurer votre Account pour les utiliser,
• Et comment utiliser l'interface utilisateur du tableau de bord pour utiliser l'API sans écrire de code.

Ce guide explique comment utiliser Roaming Insight de manière programmatique à l'aide de cURL.

Faire un appel à l'API

L'authentification pour l'API Identity Insights se fait par le biais de JWT, un jeton JSON compact et autonome. Pour générer un JWT, vous pouvez utiliser notre outil générateur en ligneou bien utiliser la fonction CLI Vonage. Vous aurez besoin de votre identifiant d'application et de votre clé privée pour générer le JWT. Une fois que vous avez votre JWT, vous pouvez envoyer une demande à l'API.

Cet exemple montre une requête cURL pour l'aperçu de l'itinérance afin de vérifier si un appareil donné est en itinérance et, le cas échéant, dans quel pays cet appareil est en itinérance :

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+990123411",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "roaming": {}
        }
    }'

L'API renvoie alors des informations sur l'itinérance pour cet appareil - s'il est en itinérance et que le pays dans lequel il est en itinérance peut être identifié, ce pays est renvoyé à l'aide de l'attribut country_codes domaine :

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "country_codes": ["DE"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
  }
}

Vous verrez les champs suivants dans la fenêtre roaming objet :

Pour en savoir plus

• Pour en savoir plus sur l'API Identity Insights, consultez la page Référence API.
• Si vous avez des questions, vous pouvez nous contacter à l'adresse suivante Communauté Vonage Slack.