Number Insight API Détails techniques
L'API Number Insight de Vonage fournit des informations en temps réel sur les numéros de téléphone, vous aidant à comprendre avec qui vous vous connectez. Vérifiez instantanément si un numéro est mobile ou fixe, identifiez le réseau associé aux numéros mobiles, vérifiez si le numéro est correctement formaté et détectez les signaux de fraude potentiels.
À compter du 4 février 2027, Vonage mettra fin à Vonage Number Insights. Afin d'assurer un soutien ininterrompu et de fournir une solution plus évolutive et à l'épreuve du temps, nous vous encourageons à migrer vers notre offre améliorée : Vonage Identity Insights API. L'API Identity Insights de Vonage consolide plusieurs ensembles de données liées aux numéros de téléphone en une seule API flexible, vous permettant de demander des informations en temps réel sur un numéro de téléphone et de récupérer toute combinaison d'informations - telles que le formatage du numéro, les détails de l'opérateur, le SIM Swap et le Subscriber Match - en un seul appel.
Veuillez consulter le Guide de transition de Numbers Insightsqui fournit des conseils détaillés sur les différences entre les API, les changements nécessaires et les meilleures pratiques pour une transition en douceur.
Caractéristiques de Numbers Insight
Les fonctionnalités de l'API Number Insight sont réparties sur plusieurs plans ou points de terminaison, en fonction du type d'informations dont vous avez besoin.
Les informations sur l'opérateur sont disponibles dans les plans de base, standard et avancé, chaque point de terminaison s'appuyant sur les capacités du précédent. Par exemple, le point de terminaison Standard comprend toutes les données de localisation et de formatage du point de terminaison Basic, ainsi que des détails supplémentaires tels que le type de numéro, l'opérateur actuel (s'il s'agit d'un numéro de téléphone mobile) et l'identité de l'appelant (États-Unis uniquement). Le point de terminaison avancé offre les données les plus complètes, comprenant toutes les données des points de terminaison de base et standard, ainsi que des informations sur l'itinérance et la joignabilité.
Le plan de détection des fraudes (BETA), quant à lui, combine les mesures des plans susmentionnés avec des sources de données supplémentaires pour évaluer si un numéro est probablement frauduleux, comme dans les cas d'échanges récents de cartes SIM.
Comparaison des caractéristiques
| Fonctionnalité | De base | Standard | Avancé |
|---|---|---|---|
| Format et origine des nombres | |||
| Informations sur le pays (code du pays, nom, préfixe) | |||
| Opérateur actuel (code réseau, nom, pays, type de réseau) | |||
| Opérateur d'origine (code réseau, nom, pays, type de réseau) | |||
| Informations sur le portage | |||
| Validité* | |||
| Accessibilité* | |||
| Statut d'itinérance* | |||
| Opérateur et pays d'itinérance* | |||
| CNAM (add-on) |
* Disponible uniquement sur certains marchés. Veuillez tester et/ou contacter le service commercial pour plus d'informations.
Vérifiez la législation en vigueur dans votre pays pour vous assurer que vous êtes autorisé à enregistrer les informations d'itinérance de l'utilisateur.
Pour commencer
Cet exemple vous montre comment utiliser la fonction CLI Vonage pour accéder à l'API de base de Number Insight et afficher des informations sur un numéro.
Pour des exemples d'utilisation de Basic, Standard et Advanced Number Insight avec curl et les SDK pour les développeurs voient le Extraits de code.
Avant de commencer :
- S'inscrire à un Compte API Vonage
- Installer Node.JS
Installer et configurer le CLI de Vonage
$ npm install --location=global @vonage/cli
Note : En fonction de vos droits d'utilisateur, il se peut que vous deviez faire précéder la commande ci-dessus de la mention sudo.
Utilisez votre VONAGE_API_KEY et VONAGE_API_SECRET de la page de démarrage du tableau de bord pour configurer le CLI de Vonage avec vos informations d'identification :
Exécuter une recherche Number Insight API Basic
Exécutez l'exemple de commande ci-dessous, en remplaçant le numéro de téléphone par celui sur lequel vous souhaitez obtenir des informations :