Transporteur original

L'aperçu de l'opérateur d'origine fournit des informations à faible latence sur l'opérateur et le type de réseau associés à l'origine à un numéro de téléphone, en utilisant l'intelligence du plan de numérotation propriétaire de Vonage. Il offre des métadonnées sans nécessiter de requêtes en direct auprès de fournisseurs ou d'opérateurs tiers, ce qui le rend rapide et fiable pour de nombreux cas d'utilisation.

Bien que cet aperçu se concentre sur l'attribution initiale plutôt que sur les changements ultérieurs, et ne reflète donc pas les changements de portabilité, il reste très utile pour identifier la nature d'un numéro de téléphone. Elle peut indiquer si un numéro a été initialement désigné comme mobile, fixe, gratuit, surtaxé ou virtuel - catégories souvent pertinentes pour la prévention de la fraude, le contrôle des coûts et la qualification des utilisateurs.

Les principaux avantages sont les suivants :

• Signaux de risque de fraude : Repérer les types de numéros virtuels, premium ou à haut risque qui peuvent indiquer une usurpation d'identité ou un trafic artificiellement gonflé.
• Le rapport coût-efficacité : Évitez de vous engager avec des Numbers coûteux ou non valides dès le début du processus.
• Qualité des données : Présélectionner les prospects et les dossiers clients en comprenant l'origine du numéro.

Original Carrier est idéal pour les entreprises qui cherchent à rationaliser les communications, à réduire le trafic artificiellement gonflé et à optimiser leurs flux de travail basés sur les numéros grâce à une intelligence légère.

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 l'outil Original Carrier Insight par programme à 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 du transporteur d'origine :

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

L'API renvoie alors des informations sur le réseau auquel le numéro de téléphone a été attribué à l'origine, notamment le nom, le type de réseau et l'indicatif de pays :

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "original_carrier": {
        "name": "Orange Espana, S.A. Unipersonal",
        "network_type": "MOBILE",
        "country_code": "ES",
        "network_code": "21403",
        "status": {
        "code": "OK",
        "message": "Success"
        }
    }
  }
}

Vous verrez les champs suivants dans la fenêtre original_carrier 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.