{"id":9458,"date":"2024-06-19T17:20:42","date_gmt":"2024-06-19T16:20:42","guid":{"rendered":"https:\/\/www.verificaremails.com\/api-de-pesquisa-de-hlr-para-validacao-de-numero-de-telefone\/"},"modified":"2025-07-29T17:13:59","modified_gmt":"2025-07-29T16:13:59","slug":"api-de-pesquisa-de-hlr-para-validacao-de-numero-de-telefone","status":"publish","type":"post","link":"https:\/\/www.verificaremails.com\/pt-br\/api-de-pesquisa-de-hlr-para-validacao-de-numero-de-telefone\/","title":{"rendered":"API de pesquisa de HLR para valida\u00e7\u00e3o de n\u00famero de telefone"},"content":{"rendered":"

Neste artigo, voc\u00ea aprender\u00e1 a usar a API HLR Lookup para validar n\u00fameros de telefone em tempo real. Voc\u00ea ver\u00e1 como realizar valida\u00e7\u00f5es individuais, valida\u00e7\u00f5es em massa por meio de arquivos e como automatizar os processos para criar um validador de n\u00fameros por meio da API. Examinaremos v\u00e1rios exemplos de c\u00f3digo, com foco em algumas linguagens, como PHP e JavaScript. Por fim, veremos como usar a documenta\u00e7\u00e3o da API de verifica\u00e7\u00e3o de n\u00famero de telefone.<\/p>\n

O que \u00e9 uma API REST?<\/h3>\n

Uma
\nAPI REST<\/strong>
\n<\/b> (Application Programming Interface Representational State Transfer) \u00e9 uma forma de comunica\u00e7\u00e3o entre sistemas que usa conven\u00e7\u00f5es HTTP. Imagine que ele \u00e9 um mensageiro que transporta solicita\u00e7\u00f5es e respostas entre seu aplicativo e um servidor. As APIs REST s\u00e3o amplamente usadas devido \u00e0 sua simplicidade e efici\u00eancia.<\/p>\n

Principais componentes de uma API REST<\/h3>\n
    \n

  1. \nRecursos<\/strong>
    \n<\/b>Representam dados, como usu\u00e1rios ou produtos.<\/li>\n

  2. \nVerbos HTTP<\/strong>
    \n<\/b>M\u00e9todos como GET, POST, PUT e DELETE para interagir com recursos.<\/li>\n

  3. \nPontos de extremidade<\/strong>
    \n<\/b>URLs que indicam onde um recurso espec\u00edfico est\u00e1 localizado.<\/li>\n

  4. \nFormato dos dados<\/strong>
    \n<\/b>Geralmente JSON ou XML.<\/li>\n<\/ol>\n

    Exemplo pr\u00e1tico: verifica\u00e7\u00e3o do n\u00famero de telefone com a pesquisa de HLR<\/h3>\n

    Verifica\u00e7\u00e3o de n\u00fameros de telefone usando
    \nHLR Lookup<\/strong>
    \n<\/b>(Home Location Register Lookup<\/a>) permite que voc\u00ea saiba se um n\u00famero \u00e9 v\u00e1lido e est\u00e1 ativo. Isso \u00e9 \u00fatil para empresas que desejam garantir que suas mensagens cheguem aos destinat\u00e1rios certos.<\/p>\n

    Processo de verifica\u00e7\u00e3o<\/h4>\n
      \n

    1. \nVoc\u00ea envia uma solicita\u00e7\u00e3o<\/strong>
      \n<\/b> com o n\u00famero de telefone para a API de pesquisa de HLR.<\/li>\n

    2. \nA API de valida\u00e7\u00e3o consulta<\/strong>
      \n<\/b> o banco de dados HLR da operadora telef\u00f4nica.<\/li>\n

    3. \nVoc\u00ea recebe uma resposta<\/strong>
      \n<\/b> indicando o status do n\u00famero de telefone.<\/li>\n<\/ol>\n

      Implementa\u00e7\u00e3o passo a passo usando a API do verificaremails.com<\/h4>\n
        \n

      1. \nRegistre-se em<\/strong>
        \n<\/b> em         verificaremails.com\/pt-br<\/a> e obtenha sua chave de API.<\/li>\n

      2. \nEnvia uma solicita\u00e7\u00e3o GET<\/strong>
        \n<\/b> para a API de valida\u00e7\u00e3o do HLR Lookup.<\/li>\n<\/ol>\n
        curl -X GET \"https:\/\/www.verificaremails.com\/api\/v1\/hlr?phone_number=1234567890\" \r\n-H \"apikey: TU_CLAVE_API\"<\/pre>\n
          \n

        1. \nInterpretar a resposta<\/strong>
          \n<\/b>. Um exemplo de resposta pode ser:<\/li>\n<\/ol>\n
          {\r\n\"status\": \"success\",\r\n\"data\": {\r\n\"phone_number\": \"1234567890\",\r\n\"valid\": true,\r\n\"carrier\": \"Movistar\",\r\n\"country\": \"ES\"\r\n}\r\n}<\/pre>\n
          Podemos obter mais informa\u00e7\u00f5es sobre o n\u00famero de telefone, especialmente se for um n\u00famero de celular, no arquivo JSON da resposta.<\/p>\n
          Formato da resposta<\/strong><\/p>\n
          Se entrarmos em detalhes, al\u00e9m de indicar se o n\u00famero \u00e9 v\u00e1lido ou inv\u00e1lido, podemos obter informa\u00e7\u00f5es sobre a operadora telef\u00f4nica, o tipo de linha, o formato internacional do n\u00famero… Se quiser saber se o n\u00famero \u00e9 v\u00e1lido, voc\u00ea deve observar os campos IMSI, MCC, MNC e MCCMNC. Todas essas verifica\u00e7\u00f5es s\u00e3o realizadas pela API de valida\u00e7\u00e3o e exibidas no valor do campo “acess\u00edvel”.<\/p>\n
          IMSI<\/h3>\n
          O 
          \nIMSI<\/strong>
          \n<\/b> (International Mobile Subscriber Identity) \u00e9 um n\u00famero exclusivo associado a cada usu\u00e1rio de rede m\u00f3vel. Esse n\u00famero \u00e9 armazenado no cart\u00e3o SIM e \u00e9 usado pelas redes m\u00f3veis para identificar os assinantes.<\/p>\n
          Componentes do IMSI<\/h3>\n
          O IMSI \u00e9 composto de tr\u00eas partes:<\/p>\n
            \n

          1. \nMCC (C\u00f3digo de pa\u00eds m\u00f3vel)<\/strong>
            \n<\/b>C\u00f3digo de tr\u00eas d\u00edgitos que identifica o pa\u00eds do assinante.<\/li>\n

          2. \nMNC (C\u00f3digo de rede m\u00f3vel)<\/strong>
            \n<\/b>C\u00f3digo de dois ou tr\u00eas d\u00edgitos que identifica a rede m\u00f3vel no pa\u00eds.<\/li>\n

          3. \nMSIN (N\u00famero de identifica\u00e7\u00e3o do assinante m\u00f3vel)<\/strong>
            \n<\/b>N\u00famero exclusivo que identifica o assinante na rede m\u00f3vel.<\/li>\n<\/ol>\n
            MCC e MNC<\/h3>\n