Detalles técnicos de Number Insight API
La Number Insight API de Vonage ofrece información en tiempo real sobre los números de teléfono, lo que te ayuda a saber con quién te estás comunicando. Verifica al instante si un número es de móvil o de fijo, identifica la red asociada a los números de móvil, comprueba si el número tiene el formato correcto y detecta posibles señales de fraude.
A partir del 4 de febrero de 2027, Vonage dejará de ofrecer el servicio «Vonage Number Insights». Para garantizar una asistencia ininterrumpida y ofrecer una solución más escalable y preparada para el futuro, le recomendamos que migre a nuestra oferta mejorada: API de información de identidad de Vonage. La API «Vonage Identity Insights» agrupa varios conjuntos de datos relacionados con números de teléfono en una única API flexible, lo que te permite solicitar información en tiempo real sobre un número de teléfono y obtener cualquier combinación de datos —como el formato del número, los detalles del operador, el cambio de tarjeta SIM y la coincidencia de abonados— en una sola llamada.
Por favor, revise el Guía de transición Number Insightsque ofrece información detallada sobre las diferencias entre las API, los cambios necesarios y las mejores prácticas para una transición sin problemas.
Funciones de Number Insight
Las funciones de Number Insight API se distribuyen en varios planes o puntos finales, en función del tipo de información que necesite.
La información sobre el operador está disponible en los planes Básico, Estándar y Avanzado, y cada punto final amplía las capacidades del anterior. Por ejemplo, el punto final Estándar incluye todos los datos de configuración regional y formato del punto final Básico, junto con detalles adicionales como el tipo de número, el operador actual (si se trata de un número de móvil) y la identidad de la persona que llama (solo en EE. UU.). El punto final «Avanzado» ofrece los datos más completos, incluyendo todo lo que ofrecen los puntos finales «Básico» y «Estándar», además de información sobre itinerancia y accesibilidad.
El Plan de Detección de Fraudes (BETA), por su parte, combina métricas de los planes mencionados con fuentes de datos adicionales para evaluar si un número es probablemente fraudulento, como en los casos de recientes intercambios de SIM.
Comparación de características
| Característica | Básico | Estándar | Avanzado |
|---|---|---|---|
| Formato y origen de los números | |||
| Información sobre el país (código de país, nombre, prefijo) | |||
| Operador actual (código de red, nombre, país, tipo de red) | |||
| Operador original (código de red, nombre, país, tipo de red) | |||
| Información sobre la adaptación | |||
| Validez* | |||
| Accesibilidad* | |||
| Estado de itinerancia* | |||
| Operador de itinerancia y país | |||
| CNAM (complemento) |
* Disponible únicamente en determinados mercados. Por favor, pruébalo y/o ponte en contacto con el departamento de ventas para obtener más información.
Consulta la legislación de tu país para asegurarte de que está permitido almacenar información sobre el roaming de los usuarios.
Primeros pasos
Este ejemplo te muestra cómo utilizar el CLI de Vonage para acceder a la Number Insight API Basic y mostrar información sobre un número.
Para ver ejemplos de cómo utilizar las funciones «Basic», «Standard» y «Advanced» de Number Insight con curl y los SDK para desarrolladores, consulta el Fragmentos de código.
Antes de empezar:
- Inscríbete en Account de la API de Vonage
- Instale Node.JS
Instalar y configurar la CLI de Vonage
$ npm install --location=global @vonage/cli
Nota: Dependiendo de tus permisos de usuario, es posible que tengas que anteponer al comando anterior sudo.
Utiliza tu VONAGE_API_KEY y VONAGE_API_SECRET del Página de introducción al panel de control para configurar la CLI de Vonage con tus credenciales:
Ejecutar una búsqueda básica de Number Insight API
Ejecuta el comando de ejemplo que se muestra a continuación, sustituyendo el número de teléfono por aquel sobre el que quieras obtener información: