Détails techniques
L'API Identity Insights fournit une API unique permettant d'accéder à un large éventail d'attributs liés à l'opérateur, à l'abonné ou à l'appareil associé à un numéro de téléphone. Les développeurs peuvent utiliser un seul point d'accès pour récupérer divers attributs qui nécessiteraient normalement plusieurs fournisseurs, CSP et méthodes d'intégration.
Les attributs sont regroupés dans Insights, chacun correspondant à un ensemble de caractéristiques spécifiques. La disponibilité peut varier selon les régions. Le développeur spécifie simplement quel(s) aperçu(s) il souhaite récupérer en une seule demande.
Si certains aperçus sont disponibles sans enregistrement préalable, d'autres requièrent l'approbation des opérateurs de téléphonie mobile. Le tableau ci-dessous indique les informations qui doivent être approuvées. L'accès à ces informations est géré par le "Registre du réseau". Pour savoir comment demander l'accès, suivez les instructions suivantes ce guide.
| Aperçu | Description | Approbation requise ? | Couverture | Statut |
|---|---|---|---|---|
| Format | Validation du format d'un numéro de téléphone et récupération des informations qui en découlent. | Non | Dans le monde entier | Disponibilité générale |
| Transporteur original | Informations sur l'attribution initiale du réseau. Informations basées sur le préfixe du plan de numérotation. | Non | Dans le monde entier | Disponibilité générale |
| Transporteur actuel | Informations sur le réseau auquel le numéro est actuellement attribué. | Non | Dans le monde entier | Disponibilité générale |
| Échange de cartes SIM | Informations sur tout changement récent d'appariement SIM lié à un compte mobile. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Disponibilité générale |
| Vérification de l'emplacement | Vérifier si l'emplacement d'un utilisateur final se trouve dans une zone spécifiée. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Aperçu pour les développeurs |
| Correspondance des abonnés | Comparer les données de l'utilisateur final pour un numéro de téléphone avec celles qui figurent dans les fichiers d'un opérateur de réseau. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Bêta |
| Itinérance | Récupérer des informations sur l'état d'itinérance d'un appareil, y compris si l'appareil est en itinérance et, le cas échéant, dans quel pays il est en itinérance. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Aperçu pour les développeurs |
| Accessibilité | Récupérer des informations sur l'état de la connectivité d'un appareil, y compris la disponibilité des données et des SMS. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Aperçu pour les développeurs |
| Échange d'appareils | Informations sur tout changement récent d'appareil pour une carte SIM couplée à un téléphone portable. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Aperçu pour les développeurs |
| Recyclage des numéros | Vérifiez si un changement est intervenu concernant l'utilisateur associé à ce numéro de téléphone après la date indiquée. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Aperçu pour les développeurs |
| Ancienneté de l'abonné | Vérifier si la durée de validité d'un numéro de téléphone donné est supérieure à une date indiquée par le client. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Aperçu pour les développeurs |
| Vérification de l'âge | Vérifie l'âge de l'abonné associé au numéro de téléphone interrogé, en fonction d'un seuil d'âge donné. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Aperçu pour les développeurs |
| Signal d'arnaque | Fournit un « contexte téléphonique » en temps réel, permettant d'identifier une situation de fraude potentielle en temps réel. | S'inscrire par l'intermédiaire de Registre du réseau | Voir Caractéristiques du réseau | Aperçu pour les développeurs |
| Conseiller | Conseils et évaluations fondés sur les informations demandées et/ou disponibles dans une demande « Identity Insights ». | Non | Dans le monde entier | Aperçu pour les développeurs |
Essais
Utiliser le Registre du réseau, un environnement de test sécurisé et contrôlé dans lequel les appels à l'API renvoient des données réelles uniquement pour un petit groupe de numéros de test autorisés, afin de commencer à utiliser immédiatement l'API Identity Insights. Contrairement à l'environnement de production, cela ne nécessite pas l'accord des opérateurs.
Vous pouvez également accéder à la Opérateur virtuelun opérateur simulé qui génère des réponses fausses mais déterministes pour les Numbers virtuels.
Référence API
La spécification OpenAPI pour l'API Identity Insights est disponible. ici.
Critères d'évaluation régionaux
Il existe plusieurs points de terminaison pour l'API Identity Insights, qui définissent l'endroit où la demande d'API est envoyée :
| Point final | Région |
|---|---|
https://api-eu.vonage.com/identity-insights/v1/requests |
EU |
https://api-us.vonage.com/identity-insights/v1/requests |
US |
Pour commencer
Vérifier Pour commencer pour obtenir un guide étape par étape sur la façon d'utiliser l'API Identity Insights.
Rapports
La Reports API constitue un moyen centralisé d'extraire des données d'utilisation et de reporting pour l'ensemble des produits Vonage, offrant ainsi aux développeurs et aux entreprises un moyen cohérent de suivre l'activité, la facturation et les détails des transactions. Elle simplifie le reporting en regroupant les données d'utilisation et de facturation provenant de plusieurs API Vonage dans un format unique et cohérent. Vous pouvez utiliser la Reports API dans un large éventail de cas d'utilisation, notamment :
- Facturation des clients - Téléchargez les transactions liées à tous vos sous-comptes et utilisez les données de prix incluses pour déterminer ce que vous devez facturer à vos clients.
- Rapprochement des factures - Comparez vos données d'utilisation avec la facture que vous avez reçue.
- Surveillance et analyse - Ajoutez des données CDR en temps réel à votre système de veille stratégique ou d'analyse pour les mettre en corrélation avec d'autres événements.
- Débogage - Résoudre les problèmes en explorant jusqu'à 13 mois de données d'utilisation détaillées.
Voir le Documentation sur les Reports API pour plus d'informations, notamment des guides, des extraits de code, des bonnes pratiques et les tarifs.