Neste artigo, você aprenderá a usar a API HLR Lookup para validar números de telefone em tempo real. Você verá como realizar validações individuais, validações em massa por meio de arquivos e como automatizar os processos para criar um validador de números por meio da API. Examinaremos vários exemplos de código, com foco em algumas linguagens, como PHP e JavaScript. Por fim, veremos como usar a documentação da API de verificação de número de telefone.
O que é uma API REST?
Uma
API REST
(Application Programming Interface Representational State Transfer) é uma forma de comunicação entre sistemas que usa convenções HTTP. Imagine que ele é um mensageiro que transporta solicitações e respostas entre seu aplicativo e um servidor. As APIs REST são amplamente usadas devido à sua simplicidade e eficiência.
Principais componentes de uma API REST
Recursos
Representam dados, como usuários ou produtos.
Verbos HTTP
Métodos como GET, POST, PUT e DELETE para interagir com recursos.
Pontos de extremidade
URLs que indicam onde um recurso específico está localizado.
Formato dos dados
Geralmente JSON ou XML.
Exemplo prático: verificação do número de telefone com a pesquisa de HLR
Verificação de números de telefone usando
HLR Lookup
(Home Location Register Lookup) permite que você saiba se um número é válido e está ativo. Isso é útil para empresas que desejam garantir que suas mensagens cheguem aos destinatários certos.
Processo de verificação
Você envia uma solicitação
com o número de telefone para a API de pesquisa de HLR.
A API de validação consulta
o banco de dados HLR da operadora telefônica.
Você recebe uma resposta
indicando o status do número de telefone.
Implementação passo a passo usando a API do verificaremails.com
Registre-se em
em verificaremails.com e obtenha sua chave de API.
Envia uma solicitação GET
para a API de validação do HLR Lookup.
curl -X GET "https://www.verificaremails.com/api/v1/hlr?phone_number=1234567890" -H "apikey: TU_CLAVE_API"
Interpretar a resposta
. Um exemplo de resposta pode ser:
{
"status": "success",
"data": {
"phone_number": "1234567890",
"valid": true,
"carrier": "Movistar",
"country": "ES"
}
}
Podemos obter mais informações sobre o número de telefone, especialmente se for um número de celular, no arquivo JSON da resposta.
Formato da resposta
Se entrarmos em detalhes, além de indicar se o número é válido ou inválido, podemos obter informações sobre a operadora telefônica, o tipo de linha, o formato internacional do número… Se quiser saber se o número é válido, você deve observar os campos IMSI, MCC, MNC e MCCMNC. Todas essas verificações são realizadas pela API de validação e exibidas no valor do campo “acessível”.
IMSI
O
IMSI
(International Mobile Subscriber Identity) é um número exclusivo associado a cada usuário de rede móvel. Esse número é armazenado no cartão SIM e é usado pelas redes móveis para identificar os assinantes.
Componentes do IMSI
O IMSI é composto de três partes:
MCC (Código de país móvel)
Código de três dígitos que identifica o país do assinante.
MNC (Código de rede móvel)
Código de dois ou três dígitos que identifica a rede móvel no país.
MSIN (Número de identificação do assinante móvel)
Número exclusivo que identifica o assinante na rede móvel.
MCC e MNC
MCC
Cada país tem um CQI exclusivo. Por exemplo, a Espanha tem MCC 214.
MNC
As operadoras de um país têm NQFs diferentes. Por exemplo, na Espanha, a Movistar tem a MNC 07.
MCCMNC
A
MCCMNC
é a combinação da MCC e da MNC. É usado para identificar de forma exclusiva uma rede móvel em um país. Por exemplo, o MCCMNC da Movistar na Espanha seria 21407.
Verificação de número de telefone
Para verificar se um número de telefone é genuíno usando o IMSI:
Obter o IMSI
Obter o IMSI: Extraia o IMSI do cartão SIM do telefone.
Analisando o IMSI
:-
- Extraia o MCC e o MNC do IMSI.
- Verifique se o MCC corresponde ao país esperado.
- Verifique se o MNC corresponde a uma operadora válida naquele país.
Validação
:-
- Verifique se o MCCMNC existe e é válido.
- Certifique-se de que o MSIN esteja correto e ativo na rede.
Exemplo
Se você tiver um IMSI 214071234567890, poderá dividi-lo da seguinte forma:
MCC
: 214 (Espanha)
MNC
: 07 (Movistar)
MSIN
1234567890 (Identificador exclusivo do assinante)
Ao verificar o MCC e o MNC, você pode confirmar que o número de telefone pertence a um assinante da Movistar na Espanha, o que ajuda a validar sua autenticidade.
{
“id”: “364215”,
“term”: “34677934019”,
“request_id”: “364215”,
“result_code”: “101”,
“result_type”: “Connected”,
“result”: {
“phone_number”: “+34677934019”,
“number_type”: “mobile”,
“fuso horário”: “Atlântico/Canário”,
“formato”: {
“e164”: “+34677934019”,
“internacional”: “+34 677 93 40 19”,
“nacional”: “677 93 40 19”,
“rfc3966”: “tel:+34-677-93-40-19”
},
“is_ported”: true,
“acessível”: “conectado”,
“processing_status”: “completed”,
“imsi”: “214040000000000”,
“current_network”: {
“country_iso2”: “EN”,
“country_prefix”: “34”,
“country_name”: “Espanha”,
“mccmnc”: “21404”,
“mcc”: “214”,
“mnc”: “04”,
“área”: “EN”,
“nome_da_rede”: “Yoigo”.
},
“original_network”: {
“country_iso2”: “EN”,
“country_prefix”: “34”,
“country_name”: “Espanha”,
“mccmnc”: “21401”,
“mcc”: “214”,
“mnc”: “01”,
“área”: “EN”,
“nome_da_rede”: “Vodafone”.
}
}
}
Como criar um validador de número de telefone com PHP
Para facilitar o uso do validador de telefone em seus formulários e aplicativos, criamos uma biblioteca POSTMAN na qual você pode fazer download das chamadas de API, bem como de exemplos de código. No caso do nosso exemplo, se quisermos fazer uma chamada em PHP, devemos selecionar esse idioma na coleção Postman e o próprio aplicativo gerará a chamada PHP para validar um número de telefone.
Por que validar números de telefone
Capturar leads é caro e se tornará mais caro a cada dia. Estima-se que de 8 a 12% dos telefones capturados em formulários ou durante os processos de registro estejam errados. A verificação de dados no ponto de coleta permite que esses erros sejam detectados e que as taxas de registro sejam melhoradas.
Depois que o lead é capturado, ele entra em um “funil de vendas” para ser explorado. Se o número de telefone estiver errado, estaremos alocando recursos que nunca terão retorno. Nossa recomendação é verificar todos os números de telefone no momento da contratação, mas, se você não tiver feito isso, pelo menos verifique o banco de dados para ter uma visão real dos seus clientes em potencial.
Conclusões
Já vimos as diferentes maneiras de validar números de telefone. Vimos que esse serviço é adequado para a verificação de números de celular durante os processos de registro, melhorando a qualidade dos dados e evitando a captura de números inválidos. Lembre-se de que você pode aplicar a validação do HLR Lookup a telefones individuais, em massa a arquivos com um grande volume de números ou automatizando o processo com a API de validação de números.
Recomendamos que você verifique a documentação da API de validação do telefone para as diferentes chamadas e se deseja ter acesso às bibliotecas de validação nas diferentes linguagens de programação. Embora as chamadas de API sejam Rest, elas sempre facilitarão a integração do serviço para você.
