Detalles técnicos de Number Insight API
Number Insight API de Vonage ofrece información en tiempo real sobre los números de teléfono, lo que te ayuda a comprender con quién te estás conectando. Verifica al instante si un número es móvil o fijo, identifica la red asociada a los números móviles, 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 Vonage Number Insights. Para garantizar un soporte ininterrumpido y ofrecer una solución más escalable y preparada para el futuro, te recomendamos que migres a nuestra oferta mejorada: API de información de identidad de Vonage. La API Vonage Identity Insights consolida varios conjuntos de datos relacionados con números de teléfono en una API única y flexible, lo que te permite solicitar información en tiempo real sobre un número de teléfono y recuperar cualquier combinación de información, como el formato del número, los detalles del operador, SIM Swap y Subscriber Match, 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 del operador está disponible en los planes Básico, Estándar y Avanzado, y cada punto final se basa en las capacidades del anterior. Por ejemplo, el punto final Estándar incluye todos los datos de localización y formato del punto final Básico, junto con detalles adicionales como el tipo de número, el operador actual (si es un número móvil) y la identidad de la persona que llama (sólo en EE.UU.). El punto final Avanzado ofrece los datos más completos, incluyendo todo lo de 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 Numbers | |||
| 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 migración | |||
| Validez | |||
| Accesibilidad | |||
| Estado de itinerancia* | |||
| Operador de itinerancia y país | |||
| CNAM (complemento) |
* Sólo disponible en determinados mercados. Pruebe y/o póngase en contacto con el departamento de ventas para obtener más información.
Compruebe la legislación de su país para asegurarse de que se le permite guardar la información de itinerancia del usuario.
Primeros pasos
Este ejemplo muestra cómo utilizar la función CLI de Vonage para acceder a la API Number Insight Basic y mostrar información sobre un número.
Para ver ejemplos de cómo utilizar Basic, Standard y Advanced Number Insight con curl y los SDK para desarrolladores ven el Fragmentos de código.
Antes de empezar:
- Inscríbete en Cuenta API de Vonage
- Instale Node.JS
Instalar y configurar la CLI de Vonage
$ npm install --location=global @vonage/cli
Nota: Dependiendo de sus permisos de usuario, puede que necesite anteponer al comando anterior el prefijo sudo.
Utiliza tu VONAGE_API_KEY y VONAGE_API_SECRET del página de inicio del cuadro de mandos para configurar la CLI de Vonage con tus credenciales:
Ejecutar una búsqueda básica de Number Insight API
Ejecute el comando de ejemplo que se muestra a continuación, sustituyendo el número de teléfono por otro sobre el que desee obtener información: