Acabamos de lançar uma extensão da nossa API para verificação de nomes. O objetivo dessa API é extrair o nome e/ou o sobrenome de um e-mail ou de qualquer string. Vou dar a você um exemplo prático para entender sua utilidade. Vamos imaginar que temos o endereço de e-mail de um cliente, mas, no momento do registro, não solicitamos o nome e o sobrenome. É comum, especialmente em endereços de e-mail corporativos, que o nome completo ou parte dele forme o sufixo do e-mail. Esse seria o texto na frente do caractere “@”. Ex: [email protected] corresponde a um usuário com o sobrenome Pous Ex: [email protected] corresponderia a um usuário com o nome Antxon e o sobrenome Pous Ex: [email protected] corresponderia a um usuário com o nome Antxon. Todas essas informações podem ser obtidas com precisão com a API de extração de nomes e sobrenomes. Além de extrair a identidade, a API também nos permite saber o sexo da pessoa por meio da análise do nome e conhecer sua origem, pois podemos descobrir em quais países esse nome é mais comumente usado. Na imagem abaixo, você pode ver todas as informações que extraímos do e-mail “[email protected]”.
A API do Verifyemails para extrair o nome e o sobrenome de cadeias de caracteres é definida da seguinte forma:
Ponto final e método
O ponto de extremidade usa o método POST e o URL é https://api.verificarnombres.com/split.
Operação
Essa API foi projetada para analisar uma cadeia de texto e extrair possíveis nomes e sobrenomes dela. Ela é especialmente útil para processar dados não estruturados e obter informações de contato de forma automatizada.
Parâmetros de entrada
A API requer o seguinte parâmetro no corpo da solicitação:
- text: A cadeia de texto da qual você deseja extrair os nomes e sobrenomes.
Resposta
A API retorna uma resposta JSON com as seguintes informações:
- name: O nome retirado do texto.
- sobrenome: O sobrenome retirado do texto.
- full_name: o nome completo extraído, combinando o nome e o sobrenome.
{“status”: true,“mensagem”: {“result”: {“first_name”: {“country”: {“Bolívia, Estado Plurinacional da”: 0,004,“Espanha”: 0,939,“França”: 0,026,“Itália”: 0,013,“México”: 0,009,“Estados Unidos”: 0,009},“gender”: {“Feminino: 0,009,“Masculino: 0,991},“classificação”: {“Espanha: 2534,“Bolívia, Estado Plurinacional da”: nulo,“França”: nulo,“Itália”: nulo,“México”: nulo,“United States”: nulo},” nome: “Antxon},“last_name”: {“country”: {“Canadá”: 0,007,“Suíça”: 0,014,“Chile”: 0,01,“Argélia”: 0,071,“Espanha”: 0,378,“França: 0,429,“Itália”: 0,01,“Marrocos”: 0,01,“México”: 0,024, “Estados UnidosStates”: 0,047}, “gender”: {}, “rank”: {“Spain”: 6987, “Canada”: nulo, “Switzerland”: nulo, “Chile”: nulo, “Algeria”:nulo,“França”: nulo,“Itália”: nulo,“Morocco”: nulo,“México”: nulo,“United States”: nulo},“name”: “Pous”.},“last_name2”: nulo}}}
Uso prático
Essa API é particularmente útil em cenários como:
- Processamento de e-mails ou documentos para extrair informações de contato.
- Análise de bancos de dados não estruturados para obter nomes de indivíduos.
- Automação de tarefas de entrada de dados em sistemas CRM ou similares.
A capacidade de extrair nomes e sobrenomes de cadeias de texto permite que empresas e desenvolvedores aumentem a eficiência no manuseio de dados pessoais e no gerenciamento de contatos.