No mundo digital de hoje, é muito importante garantir que os números de telefone sejam reais e funcionem bem para empresas e indivíduos. A necessidade de verificar os números de telefone levou ao desenvolvimento de novas tecnologias, como a API HLR Lookup. Essa ferramenta útil ajuda a verificar números de celulares e telefones fixos em todo o mundo, ajudando a evitar fraudes, melhorar a comunicação e se conectar melhor com os clientes. É fundamental ter um bom sistema para verificar os telefones, pois isso afeta diretamente a forma como nos comunicamos e protegemos nossas conversas pessoais e de trabalho.

Este artigo explica como você pode usar a API HLR Lookup para verificar números de telefone. Começaremos com uma introdução à API de pesquisa de HLR e, em seguida, forneceremos a você um guia passo a passo sobre como usá-la bem. Você aprenderá a consultar a API, entenderá as respostas que recebe e saberá o que significa cada informação fornecida pela API. Ao final da leitura, você saberá como validar números de telefone com segurança, certificando-se de que seus contatos são corretos e confiáveis.

Visão geral da API de pesquisa do HLR

O HLR Lookup é uma ferramenta poderosa para verificar a validade e o status dos números de telefones celulares. HLR significa Home Location Register (Registro de localização residencial), que é um banco de dados centralizado usado pelas operadoras de rede móvel para armazenar informações sobre os assinantes de suas redes.

O que é HLR?

HLR é uma abreviação de Home Location Register (Registro de localização residencial), que é um banco de dados centralizado usado pelas operadoras de rede móvel para armazenar informações sobre os assinantes de suas redes. A verificação de pesquisa de HLR permite que as empresas determinem se um número de telefone celular é válido, ativo e registrado na rede de uma operadora de celular específica.

Importância da validação do número de telefone

A validação dos números de telefone é fundamental por vários motivos:

1. Ele garante a precisão dos detalhes de contato do cliente, o que ajuda a evitar erros e mal-entendidos na comunicação.
2. Ele ajuda as empresas a se protegerem contra tentativas de fraude e phishing, verificando a validade dos números de telefones celulares.
3. Aumente a eficiência operacional e a lucratividade, evitando o envio de mensagens ou chamadas para números incorretos ou inválidos.

Casos de uso

A API de pesquisa de HLR tem aplicações em vários setores, incluindo:

• Telecomunicações: As empresas de telefonia móvel podem usar a pesquisa de HLR para validar os números de telefone celular de seus clientes e garantir uma comunicação eficiente.
• Marketing e publicidade: a pesquisa de HLR pode ser usada para garantir que as mensagens de texto e as chamadas telefônicas cheguem aos clientes certos, evitando assim o desperdício de recursos.
• Setor financeiro: a verificação de pesquisa do HLR é essencial para garantir a segurança das transações e proteger os clientes contra fraudes.

Em resumo, a API HLR Lookup é uma ferramenta essencial para qualquer empresa que dependa de uma comunicação eficaz com seus clientes. Ao verificar a validade e o status dos números de telefone celular, as empresas podem melhorar a precisão dos dados de contato, aumentar a eficiência operacional e proteger-se contra fraudes. Para obter mais informações, visite a seção Verificar telefone com a API HLR Lookup.

Guia passo a passo para usar a API de pesquisa do HLR

Para começar a usar a API para verificar telefones, siga estas etapas:

Registre-se e obtenha sua chave de API

1. Crie uma conta em verificaremails.com. O registro levará apenas alguns minutos.
2. Uma vez registrado, solicite sua avaliação gratuita. Isso fornecerá a você um saldo de teste para realizar validações com a API.
3. Obtenha sua chave de API na seção Configurações de API da sua conta. Essa chave será usada como uma senha para acessar a API.

Configuração e integração básicas

1. Familiarize-se com o URL do ponto de extremidade da API do HLR: https://dashboard.verificaremails.com/myapi/phone/validate/single
2. O método de autenticação usado é o HTTP Basic Auth. username:tokenapi base64()Inclua suas credenciais no cabeçalho da solicitação HTTP codificado em .
3. Os principais parâmetros de uma consulta ao HLR são:
   • numbersNúmero de telefone: números de telefone a serem validados no formato internacional E.164 sem “+” ou “00”. Você pode incluir um único número ou uma lista separada por vírgulas (máximo de 100).
   • typeTipo de teste de HLR. Valores possíveis: “phone”, “phonemnp”, “phonesintactic” indicados na estrutura da chamada.
4. O resultado da solicitação é obtido no formato JSON com informações detalhadas sobre cada número.

Exemplos de código

Aqui está um exemplo de como executar uma consulta ao HLR usando 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;

Esse código executa uma consulta ao HLR para validar o status de um número de telefone. Você pode adaptá-lo de acordo com suas necessidades.

Lembre-se de que a Verificaremails oferece bibliotecas e plug-ins para facilitar a integração com várias linguagens de programação e plataformas.

Se você tiver alguma dúvida ou precisar de assistência durante o processo de integração, não hesite em entrar em contato com a equipe de suporte técnico. Recomendamos que você visualize o arquivo Postman com as chamadas de API do HLR.

Fazer chamadas de API

Para fazer chamadas à API HLR Lookup, você pode usar solicitações HTTP GET ou POST. https://dashboard.verificaremails.com/myapi/phone/validate/single O ponto de extremidade da API é .

Validação de número único

Para validar um número de telefone individual, faça uma solicitação GET ao ponto de extremidade da API com os seguintes parâmetros:

• phone_numberNúmero de telefone: O número de telefone que você deseja validar em formato internacional (por exemplo, +34677934019).
• apikeySua chave de API fornecida pela Verificaremails.

Exemplo de uma solicitação usando cURL:

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

A resposta da API será um objeto JSON com informações detalhadas sobre o número de telefone, incluindo a validade, a operadora, o status da portabilidade e muito mais.

Validação do número do lote

Para validar vários números de telefone de uma só vez, você pode usar o recurso de validação em lote da API. Faça uma solicitação POST para o mesmo endpoint com os seguintes parâmetros:

• phone_numbersNúmero de telefone: Uma lista separada por vírgulas de números de telefone em formato internacional.
• apikeySua chave de API fornecida pela Verificaremails.
• fileArquivo: O arquivo que contém os números de telefone a serem validados.
• columnA coluna em que os números estão localizados no arquivo.
• send_emailEndereço de e-mail: O endereço de e-mail a ser notificado sobre a conclusão da verificação.
• callback_urlURL de chamada para notificar o fim da verificação: O URL de chamada para notificar o fim da verificação.

Exemplo de uma solicitação 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'

A resposta da API será um objeto JSON com informações detalhadas sobre cada número de telefone da lista.

TU_CLAVE_API Lembre-se de substituir por sua chave de API real fornecida por verificaremails.com. Além disso, certifique-se de tratar adequadamente as respostas da API em seu código, incluindo o tratamento de erros e a interpretação dos dados retornados.

Para obter mais informações sobre parâmetros adicionais e códigos de resposta da API, consulte a documentação completa da API HLR Lookup.

Interpretação de respostas de API

Depois de fazer uma solicitação à API, você receberá uma resposta no formato JSON contendo informações detalhadas sobre o número de telefone validado. É fundamental entender a estrutura da resposta e os campos comuns para que você possa interpretar corretamente os resultados.

Compreender a estrutura da resposta

A resposta da API é retornada no formato JSON, que é um formato de intercâmbio de dados legível e fácil de analisar. A estrutura típica da resposta inclui os seguintes elementos:

1. id	Tipo	Valor Null	Descrição
   id	cadeia de caracteres		ID exclusivo da solicitação.
   custo	flutuante		Número de tokens usados na verificação.
   número de telefone	cadeia de caracteres		Número de telefone no formato E.164.
   tipo de número	cadeia de caracteres		Tipo de número de telefone (fixo ou móvel) Tipos de números
   fuso horário	string		Fuso horário em que o número foi originalmente atribuído. Em nenhum caso ele rastreia o fuso horário em que o usuário está localizado no momento da verificação.
   is_ported	bool	✓	Indica se o número foi portado. Nulo será exibido se essas informações não estiverem disponíveis.
   acessível	string		A acessibilidade é indicada no momento exato da verificação. Para obter mais informações, consulte Reachability State.
   imsi	string	✓	Identidade Internacional de Assinante Móvel (IMSI). Identificador exclusivo associado ao cartão SIM. A disponibilidade do IMSI depende da operadora de celular do cartão.
   formato.e164	cadeia de caracteres		O número no formato E.164.
   format.international	string		O número no formato internacional.
   format.national	cadeia de caracteres		O número no formato nacional.
   formato.rfc3966	string		O número formatado no formato RFC3966.
   original_network.country_iso2	cadeia de caracteres		O código do país (ISO2) ao qual o número foi atribuído originalmente.
   original_network.country_prefix	cadeia de caracteres		O prefixo de chamada internacional ao qual o número foi originalmente atribuído.
   original_network.area	string	✓	O nome da área à qual o número foi atribuído.
   rede_original.mccmnc	string	✓	Cinco ou seis caracteres MCCMNC (código de país móvel + tupla de código de rede móvel) que identificam a rede original que emitiu o número.
   rede_original.mcc	string	✓	Três caracteres MCC (código de país móvel) que identificam a rede em que o número foi emitido.
   original_network.mnc	string	✓	Dois ou três caracteres MNC (código de rede móvel) que identificam a rede em que o número foi emitido.
   original_network.network_name	string	✓	Nome da operadora que emitiu o número, se disponível.
   rede_atual.país_iso2	string	✓	Código do país (ISO2) ao qual o número está atribuído atualmente.
   current_network.country_prefix	cadeia de caracteres		O prefixo internacional ao qual o número está atribuído atualmente.
   rede_atual.área	string	✓	Nome da área em que o número está atualmente atribuído, se disponível.
   rede_atual.mccmnc	string	✓	Cinco ou seis caracteres MCCMNC (código de país móvel + tupla de código de rede móvel) que identificam a rede à qual o número pertence atualmente.
   rede_atual.mcc	string	✓	Três caracteres MCC (código de país móvel) que identificam o país ao qual o número pertence atualmente.
   rede_atual.mnc	string	✓	Dois ou três caracteres MNC (código de rede móvel) que identificam a rede à qual o número pertence atualmente.
   rede_atual.nome_da_rede	string	✓	O nome da operadora à qual o número está atribuído atualmente, se disponível.

Campos de resposta comuns

Alguns dos campos mais importantes na resposta da API são:

Tratamento de erros e solução de problemas

Se a resposta da API indicar um erro (status: false), o campo “message” (mensagem) deverá fornecer detalhes sobre o problema. Alguns erros comuns incluem:

• Chave de API inválida ou ausente
• Número de telefone inválido ou em um formato incorreto
• Dotações insuficientes na conta

Para resolver esses problemas, verifique se você está usando a chave de API correta, se o número de telefone está no formato internacional correto e se você tem créditos suficientes em sua conta.

Se o campo “resultado” mostrar “desconhecido”, isso pode indicar que todos os seus créditos foram usados. Nesse caso, você precisará recarregar sua conta para continuar usando o serviço de verificação de número de telefone.