En el mundo digital de hoy, es muy importante asegurar que los números de teléfono sean reales y funcionen bien, tanto para empresas como para personas. La necesidad de comprobar números de teléfono ha llevado a crear nuevas tecnologías, como la API HLR Lookup. Esta herramienta útil ayuda a verificar números de móviles y fijos en todo el mundo, lo que ayuda a evitar fraudes, mejorar la comunicación y conectar mejor con los clientes. Es crucial tener un buen sistema para verificar teléfonos, ya que afecta directamente a cómo nos comunicamos y protegemos nuestras conversaciones personales y de trabajo.

Este artículo te explicará cómo usar la API HLR Lookup para comprobar números de teléfono. Empezaremos con una introducción a la API HLR Lookup y luego te daremos una guía paso a paso sobre cómo usarla bien. Aprenderás a hacer consultas a la API, entender las respuestas que recibes y saber qué significa cada dato que te da la API. Al terminar de leer, sabrás cómo validar números de teléfono con seguridad, asegurándote de que tus contactos son correctos y confiables.

Descripción general de la API de búsqueda HLR

El HLR Lookup es una poderosa herramienta que permite verificar la validez y el estado de los números de teléfono móvil. HLR significa Home Location Register, que es una base de datos centralizada utilizada por los operadores de redes móviles para almacenar información sobre los suscriptores de sus redes.

¿Qué es HLR?

HLR es una abreviatura de Home Location Register, que es una base de datos centralizada utilizada por los operadores de redes móviles para almacenar información sobre los suscriptores de sus redes. La verificación de HLR lookup permite a las empresas determinar si un número de teléfono móvil es válido, activo y está registrado en la red de un operador móvil específico.

Importancia de la validación de números de teléfono

La validación de números de teléfono es crucial por varias razones:

1. Garantiza la precisión de los datos de contacto de los clientes, lo que ayuda a evitar errores y malentendidos en la comunicación.
2. Ayuda a las empresas a protegerse contra el fraude y los intentos de phishing al verificar la validez de los números de teléfono móvil.
3. Mejora la eficiencia operativa y la rentabilidad al evitar el envío de mensajes o llamadas a números incorrectos o no válidos.

Casos de uso

El HLR Lookup API tiene aplicaciones en diversas industrias, incluyendo:

• Telecomunicaciones: Las empresas de telefonía móvil pueden utilizar HLR lookup para validar los números de teléfono móvil de sus clientes y garantizar una comunicación eficiente.
• Marketing y publicidad: HLR lookup puede ser utilizado para asegurarse de que los mensajes de texto y las llamadas telefónicas lleguen a los clientes correctos, evitando así el desperdicio de recursos.
• Sector financiero: La verificación de HLR lookup es esencial para garantizar la seguridad de las transacciones y proteger a los clientes contra el fraude.

En resumen, el HLR Lookup API es una herramienta esencial para cualquier empresa que dependa de la comunicación efectiva con sus clientes. Al verificar la validez y el estado de los números de teléfono móvil, las empresas pueden mejorar la precisión de sus datos de contacto, aumentar la eficiencia operativa y protegerse contra el fraude. Para obtener más información visita la sección  verificar teléfono con HLR Lookup API.

Guía paso a paso para utilizar la API de búsqueda HLR

Para comenzar a utilizar el API  para validar números de teléfono, sigue estos pasos:

Regístrate y obtén tu clave API

1. Crea una cuenta en verificaremails.com. El registro solo te llevará unos minutos.
2. Una vez registrado, solicita tu prueba gratuita. Esto te proporcionará saldo de prueba para realizar validaciones con el API.
3. Obtén tu clave API desde la sección de Configuración API de tu cuenta. Esta clave se utilizará como contraseña para acceder al API.

Configuración básica e integración

1. Familiarízate con la URL del endpoint del API HLR: https://dashboard.verificaremails.com/myapi/phone/validate/single
2. El método de autenticación utilizado es Basic Auth HTTP. Incluye tus credenciales username:tokenapi en el encabezado de la petición HTTP codificado en base64().
3. Los parámetros principales para realizar una consulta HLR son:
   • numbers: Números de teléfono a validar en formato internacional E.164 sin «+» o «00». Puedes incluir un único número o una lista separada por comas (máximo 100).
   • type: Tipo de comprobación HLR. Valores posibles: «phone», «phonemnp», «phonesintactic» indicado en la estructura de la llamada.
4. El resultado de la petición se obtiene en formato JSON con información detallada sobre cada número.

Ejemplos de código

Aquí tienes un ejemplo de cómo realizar una consulta HLR utilizando PHP:

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://dashboard.verificaremails.com/myapi/phone/validate/single?term=34677934019&auth-token={{api_token}}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Este código realiza una consulta HLR para validar el estado de un número de teléfono. Puedes adaptarlo según tus necesidades.

Recuerda que Verificaremails ofrece librerías y plugins para facilitar la integración con diversos lenguajes de programación y plataformas.

Si tienes alguna duda o necesitas asistencia durante el proceso de integración, no dudes en contactar con el equipo de soporte técnico. Te recomendamos que veas el fichero Postman con las llamas al API HLR

Realizando llamadas al API

Para realizar llamadas al API HLR Lookup, puedes utilizar solicitudes HTTP GET o POST. El endpoint del API es https://dashboard.verificaremails.com/myapi/phone/validate/single.

Validación de un solo número

Para validar un número de teléfono individual, realiza una solicitud GET al endpoint del API con los siguientes parámetros:

• phone_number: El número de teléfono que deseas validar en formato internacional (por ejemplo, +34677934019).
• apikey: Tu clave API proporcionada por Verificaremails.

Ejemplo de solicitud usando cURL:

curl -X 'GET' \
  'https://dashboard.verificaremails.com/myapi/phone/validate/single?auth-token={{token}}&term=34677934019' \
  -H 'accept: application/json'

La respuesta del API será un objeto JSON con información detallada sobre el número de teléfono, incluyendo su validez, operador, estado de portabilidad y más.

Validación de números en lote

Para validar múltiples números de teléfono a la vez, puedes utilizar la función de validación en lote del API. Realiza una solicitud POST al mismo endpoint con los siguientes parámetros:

• phone_numbers: Una lista de números de teléfono separados por comas en formato internacional.
• apikey: Tu clave API proporcionada por Verificaremails.
• file: El fichero que contienen los números de teléfono a validar
• column: La columna donde se encuentran los números dentro del fichero.
• send_email: La dirección de email a la que se notifica la finalización de la verificación
• callback_url: La URL de llamada para notificar el fin de la verificación.

Ejemplo de solicitud usando cURL:

curl -X 'POST' \
  'https://dashboard.verificaremails.com/myapi/phone/validate/multiple?auth-token=%7B%7Btoken%7D%7D' \
  -H 'accept: application/json' \
  -H 'Content-Type: multipart/form-data' \
  -F '[email protected];type=text/plain' \
  -F 'column=1' \
  -F 'send_email=0' \
  -F 'callback_url=http://webhoock.com'

La respuesta del API será un objeto JSON con información detallada sobre cada número de teléfono en la lista.

Recuerda reemplazar TU_CLAVE_API con tu clave API real proporcionada por verificaremails.com. Además, asegúrate de manejar adecuadamente las respuestas del API en tu código, incluyendo el manejo de errores y la interpretación de los datos devueltos.

Para obtener más información sobre los parámetros adicionales y los códigos de respuesta del API, consulta la documentación completa del API HLR Lookup

Interpreting API Responses

Una vez que hayas realizado una solicitud a la API, recibirás una respuesta en formato JSON que contiene información detallada sobre el número de teléfono validado. Es crucial comprender la estructura de la respuesta y los campos comunes para interpretar correctamente los resultados.

Comprender la estructura de la respuesta

La respuesta de la API se devuelve en formato JSON, que es un formato de intercambio de datos legible y fácil de analizar. La estructura típica de la respuesta incluye los siguientes elementos:

1. id	Tipo	Valor Nulo	Description
   id	string		ID único de la petición.
   cost	float		Número de tokens utilizados en la verificación.
   phone_number	string		Número de teléfono en formato E.164 format.
   number_type	string		Tipo de número de teléfono (fijo o móvil) Number types
   timezone	string		Zona horaria donde originalmente el número fue asignado. En ningún caso traza la zona horaria donde se encuentra el usuario en el momento de la verificación.
   is_ported	bool	✓	Indica si el número ha sido portado. Se muestra null en caso de que no se disponga de esta información.
   reachable	string		Se indica la accesibilidad en el preciso momento de la verificación. Para más información ver Reachability State.
   imsi	string	✓	International Mobile Subscriber Identity (IMSI). Identificador único asociado a la tarjeta SIM. La disponibilidad del IMSI depende del operador móvil de la tarjeta.
   format.e164	string		El número en formato E.164 format.
   format.international	string		El número en formato internacional.
   format.national	string		El número en formato nacional.
   format.rfc3966	string		El número formateado en RFC3966 format.
   original_network.country_iso2	string		El Código de país (ISO2) donde originalmente el número fue asignado.
   original_network.country_prefix	string		El prefijo internacional de llamada donde el número fue originalmente asignado.
   original_network.area	string	✓	El nombre del área donde el número fue asignado.
   original_network.mccmnc	string	✓	Cinco o seis caracteres MCCMNC (mobile country code + mobile network code tuple) identificando la red original que emitió el número.
   original_network.mcc	string	✓	Tres caracteres MCC (mobile country code) identificando donde la red donde fue emitido el número.
   original_network.mnc	string	✓	Dos o tres caracteres MNC (mobile network code) identificando la red donde fue emitido el número.
   original_network.network_name	string	✓	Nombre del operador que emitió el número, si se dispone de esta información.
   current_network.country_iso2	string	✓	Código del país (ISO2) donde el numero actualmente este asignado.
   current_network.country_prefix	string		El prefijo internacional donde actualmente el número este asignado.
   current_network.area	string	✓	Nombre del área donde actualmente el numero este asignado, si se dispone de esta información.
   current_network.mccmnc	string	✓	Cinco o seis caracteres MCCMNC (mobile country code + mobile network code tuple) identificando la red donde actualmente pertenece el número.
   current_network.mcc	string	✓	Tres caracteres MCC (mobile country code) identificando el país donde actualmente pertenece el número.
   current_network.mnc	string	✓	Dos o tres caractres MNC (mobile network code) identificando la red donde actualmente el número pertenece.
   current_network.network_name	string	✓	El nombre del operador donde actualmente el número este asignado, si se dispone de esta información.

Campos de respuesta comunes

Algunos de los campos más importantes en la respuesta de la API son:

Manejo de errores y solución de problemas

Si la respuesta de la API indica un error (status: false), el campo «message» proporcionará detalles sobre el problema. Algunos errores comunes incluyen:

• Clave API inválida o faltante
• Número de teléfono no válido o en un formato incorrecto
• Créditos insuficientes en la cuenta

Para solucionar estos problemas, verifica que estés utilizando la clave API correcta, que el número de teléfono esté en el formato internacional adecuado y que tengas suficientes créditos en tu cuenta.

Si el campo «result» muestra «desconocido», esto puede indicar que todos tus créditos se han agotado. En este caso, deberás recargar tu cuenta para continuar utilizando el servicio de verificación de números de teléfono.