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 | ¿Necesita autorización? | Cobertura | Estado |
|---|---|---|---|---|
| Formato | Validación del formato de un número de teléfono y recuperació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 de emparejamiento de SIM relacionado con una cuenta de móvil. | Regístrese a través de Registro de red | Véase Funciones de red | Disponibilidad general |
| Verificación de la ubicación | Verify whether the location of an end-user is within a specified area. | Regístrese a través de Registro de red | Véase Funciones de red | Vista previa para desarrolladores |
| Coincidencia de abonados | Comparar los datos de usuario final de un número de teléfono con los que figuran en los archivos de un operador de red. | Regístrese a través de Registro de red | Véase Funciones de 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. | Regístrese a través de Registro de red | Véase Funciones de red | Vista previa para desarrolladores |
| Accesibilidad | Recupera información sobre el estado de conectividad de un dispositivo, incluida la disponibilidad de datos y SMS. | Regístrese a través de Registro de red | Véase Funciones de red | Vista previa para desarrolladores |
Parque infantil
Utiliza el Parque infantilUn entorno de pruebas seguro y controlado, en el que las llamadas a la API sólo devuelven datos en tiempo real de un pequeño grupo de números de teléfono permitidos, para empezar a utilizar la API Identity Insights de inmediato. A diferencia de la producción, no requiere la aprobación de los operadores.
También puede acceder a 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 ponerse en marcha con la API Identity Insights.