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 | Alfa |
| Reciclaje de números | Comprueba si se ha producido algún cambio en el usuario asociado al número de teléfono después de la fecha indicada. | Inscríbete a través de Registro de red | Véase Características de la red | Alfa |
| Antigüedad de los abonados | Comprueba si el periodo de vigencia de un número de teléfono determinado es superior a una fecha introducida por el cliente. | Inscríbete a través de Registro de red | Véase Características de la red | Alfa |
| Verificación de la edad | Confirma la edad del abonado asociado al número de teléfono consultado, en función de un límite de edad determinado. | Inscríbete a través de Registro de red | Véase Características de la red | Alfa |
| Señal de estafa | Proporciona «contexto de telefonía» en tiempo real, lo que permite identificar una posible situación de fraude en tiempo real. | Inscríbete a través de Registro de red | Véase Características de la red | Alfa |
| Asesor | Asesoramiento y evaluaciones basados en los datos de «Insights» solicitados y/o disponibles en una solicitud de «Identity Insights». | No | En todo el mundo | Versión preliminar para desarrolladores |
Pruebas
Utiliza el Registro de red, 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 prueba autorizados, lo que te permite 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.
Informes
La Reports API es una herramienta centralizada para recuperar datos de uso y de informes de todos los productos de Vonage, lo que ofrece a los desarrolladores y a las empresas una forma coherente de realizar un seguimiento de la actividad, la facturación y los detalles de las transacciones. Simplifica la elaboración de informes al reunir los datos de uso y facturación de varias API de Vonage en un único formato coherente. Puedes utilizar la Reports API en una amplia variedad de casos de uso, entre los que se incluyen:
- Facturación a clientes: descargue las transacciones relacionadas con todas sus subcuentas y utilice los datos de precios incluidos para determinar lo que debe facturar a sus clientes.
- Conciliación de facturas: compare sus datos de uso con la factura que ha recibido.
- Supervisión y análisis: añade datos CDR en tiempo real a tu sistema de inteligencia empresarial o de análisis para correlacionarlos con otros eventos.
- Depuración: solucione problemas explorando hasta 13 meses de datos de uso detallados.
Véase el Documentación de la Reports API Para obtener más información, como guías, fragmentos de código, prácticas recomendadas y precios.