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 |
Terrain de jeux
Utiliser le Terrain de jeuxNumbers, un environnement de test sûr et contrôlé dans lequel les appels API renvoient des données en direct uniquement pour un petit groupe de numéros de téléphone autorisés, pour commencer à utiliser l'API Identity Insights immédiatement. Contrairement à la production, il n'est pas nécessaire d'obtenir l'approbation 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.