Detalles técnicos
La API Identity Insights proporciona una única API para acceder a una amplia gama de atributos relacionados con el operador, el abonado o el dispositivo asociado a un número de teléfono. Los desarrolladores pueden aprovechar un único punto final para recuperar diversos atributos que normalmente requerirían múltiples proveedores, CSP y métodos de integración.
Los atributos se agrupan en Insights, cada uno de los cuales corresponde a un conjunto específico de características. La disponibilidad puede variar según la zona geográfica. El desarrollador sólo tiene que especificar qué Insight(s) desea recuperar en una única solicitud.
Mientras que algunos Insights están disponibles sin registro previo, otros requieren la aprobación de los operadores de telefonía móvil. En la tabla siguiente se indican los Insights que requieren aprobación. El acceso a estos Insights se gestiona a través del "Registro de Red". Para saber cómo solicitar acceso, siga estos pasos esta guía.
| Insight | Descripción | ¿Se requiere autorización? | Cobertura | Estado |
|---|---|---|---|---|
| Formato | Validación del formato de un número de teléfono y obtención de la información derivada del mismo. | No | En todo el mundo | Disponibilidad general |
| Transportista original | Información sobre la red asignada inicialmente. Información basada en el prefijo del plan de numeración. | No | En todo el mundo | Disponibilidad general |
| Transportista actual | Información sobre la red a la que está asignado el número. | No | En todo el mundo | Disponibilidad general |
| Intercambio de SIM | Información sobre cualquier cambio reciente en el emparejamiento de la tarjeta SIM relacionado con una cuenta de móvil. | Inscríbete a través de Registro de red | Véase Características de la red | Disponibilidad general |
| Verificación de la ubicación | Verify si la ubicación de un usuario final se encuentra dentro de una zona determinada. | Inscríbete a través de Registro de red | Véase Características de la red | Versión preliminar para desarrolladores |
| Coincidencia de abonados | Comparar los datos del usuario final correspondientes a un número de teléfono con los que figuran en los registros de un operador de red. | Inscríbete a través de Registro de red | Véase Características de la red | Beta |
| Itinerancia | Recuperar información sobre el estado de itinerancia de un dispositivo, incluido si el dispositivo está en itinerancia y, en caso afirmativo, en qué país. | Inscríbete a través de Registro de red | Véase Características de la red | Versión preliminar para desarrolladores |
| Accesibilidad | Obtener información sobre el estado de conectividad de un dispositivo, incluida la disponibilidad de datos y SMS. | Inscríbete a través de Registro de red | Véase Características de la red | Versión preliminar para desarrolladores |
| Intercambio de dispositivos | Información sobre cualquier cambio reciente de dispositivo en el caso de una tarjeta SIM asociada a un teléfono móvil. | Inscríbete a través de Registro de red | Véase Características de la red | Versión preliminar para desarrolladores |
Parque infantil
Utiliza el Parque infantil, un entorno de pruebas seguro y controlado en el que las llamadas a la API devuelven datos en tiempo real únicamente para un pequeño grupo de números de teléfono incluidos en la lista de permitidos, para empezar a utilizar la API de Identity Insights de inmediato. A diferencia del entorno de producción, no requiere la aprobación de los operadores.
También puedes acceder a la Operador virtualun operador simulado que genera respuestas falsas pero deterministas para Virtual Numbers.
Referencia API
La especificación OpenAPI para la API Identity Insights está disponible aquí.
Criterios regionales
Existen varios puntos finales disponibles para la API Identity Insights que definen dónde se envía la solicitud de la API:
| Punto final | Región |
|---|---|
https://api-eu.vonage.com/identity-insights/v1/requests |
EU |
https://api-us.vonage.com/identity-insights/v1/requests |
US |
Primeros pasos
Echa un vistazo Primeros pasos para obtener una guía paso a paso sobre cómo empezar a utilizar la API de Identity Insights.