{"id":5777,"date":"2024-03-18T13:19:19","date_gmt":"2024-03-18T12:19:19","guid":{"rendered":"https:\/\/verificaremails.com\/guia-passo-a-passo-como-usar-uma-api-para-validar-enderecos-de-e-mail\/"},"modified":"2026-11-15T19:55:34","modified_gmt":"2026-11-15T18:55:34","slug":"guia-passo-a-passo-como-usar-uma-api-para-validar-enderecos-de-e-mail","status":"publish","type":"post","link":"https:\/\/www.verificaremails.com\/pt-br\/guia-passo-a-passo-como-usar-uma-api-para-validar-enderecos-de-e-mail\/","title":{"rendered":"API para validar e-mail: guia passo a passo de integra\u00e7\u00e3o"},"content":{"rendered":"<p><em>Atualizado em 15 de novembro de 2026<\/em><\/p>\n<p>Uma <strong>API para validar e-mail<\/strong> recebe um endere\u00e7o, confere a sintaxe, o dom\u00ednio, os registros MX e o servidor SMTP e devolve o resultado em 1 a 2 segundos, sem enviar nenhuma mensagem ao destinat\u00e1rio. Na API do VerificarEmails, o resultado \u00e9 seguro, inv\u00e1lido, arriscado ou desconhecido. Voc\u00ea a usa em formul\u00e1rios, no CRM e em importa\u00e7\u00f5es de listas.<\/p>\n<p>Este guia explica a diferen\u00e7a entre uma API de valida\u00e7\u00e3o e uma API de envio, quando usar a valida\u00e7\u00e3o, o que cada resultado significa, como integrar a API passo a passo e como evitar bloquear clientes reais por engano. Endpoints, par\u00e2metros e formato da resposta est\u00e3o na <a href=\"https:\/\/www.verificaremails.com\/docs\/pt\/\">documenta\u00e7\u00e3o da API<\/a>.<\/p>\n<h2>Qual \u00e9 a diferen\u00e7a entre uma API de envio e uma API de valida\u00e7\u00e3o de e-mail?<\/h2>\n<p>Uma API de envio, via SMTP ou transacional, dispara mensagens: confirma\u00e7\u00e3o de pedido, redefini\u00e7\u00e3o de senha, newsletter. Uma API de valida\u00e7\u00e3o n\u00e3o envia nada: confere se o endere\u00e7o existe e pode receber e-mails antes do envio. As duas se complementam: voc\u00ea valida primeiro e entrega ao servi\u00e7o de envio s\u00f3 os endere\u00e7os confi\u00e1veis.<\/p>\n<p>Se voc\u00ea procura uma API para enviar e-mails, o VerificarEmails n\u00e3o \u00e9 esse servi\u00e7o. Mas, se voc\u00ea j\u00e1 usa um, validar os endere\u00e7os antes reduz os bounces (rejei\u00e7\u00f5es) e protege a reputa\u00e7\u00e3o do seu dom\u00ednio remetente.<\/p>\n<div style=\"overflow-x:auto\">\n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>API de envio (SMTP ou transacional)<\/th>\n<th>API de valida\u00e7\u00e3o de e-mail<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>O que faz<\/td>\n<td>Entrega mensagens aos destinat\u00e1rios<\/td>\n<td>Confere se o endere\u00e7o pode receber mensagens<\/td>\n<\/tr>\n<tr>\n<td>Envia e-mail?<\/td>\n<td>Sim<\/td>\n<td>N\u00e3o<\/td>\n<\/tr>\n<tr>\n<td>Quando chamar<\/td>\n<td>Na hora de mandar a mensagem<\/td>\n<td>No cadastro, na importa\u00e7\u00e3o ou antes de uma campanha<\/td>\n<\/tr>\n<tr>\n<td>O que devolve<\/td>\n<td>Confirma\u00e7\u00e3o de que a mensagem foi aceita e, depois, avisos de entrega ou de bounce<\/td>\n<td>Um resultado por endere\u00e7o: seguro, inv\u00e1lido, arriscado ou desconhecido<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Quando usar uma API para validar e-mail?<\/h2>\n<p>Use a API sempre que um endere\u00e7o entra no seu sistema de forma autom\u00e1tica, sem ningu\u00e9m para conferir: no formul\u00e1rio de cadastro, na sincroniza\u00e7\u00e3o com o CRM e na importa\u00e7\u00e3o de listas. Para conferir poucos endere\u00e7os \u00e0 m\u00e3o, o campo web resolve; a API serve para validar no ponto de entrada, sem interven\u00e7\u00e3o humana.<\/p>\n<ul>\n<li><strong>Formul\u00e1rios em tempo real:<\/strong> a valida\u00e7\u00e3o acontece no cadastro, no checkout ou no pedido de or\u00e7amento. Se a pessoa errou o dom\u00ednio ao digitar, ela v\u00ea o aviso e corrige na hora, antes de enviar o formul\u00e1rio.<\/li>\n<li><strong>CRM:<\/strong> valide cada contato novo ou editado antes de salv\u00e1-lo, para que vendas e marketing trabalhem com endere\u00e7os que recebem mensagens.<\/li>\n<li><strong>Importa\u00e7\u00f5es e bases antigas:<\/strong> antes de carregar a planilha de um evento ou de reativar uma lista parada, valide tudo em massa e separe os contatos por resultado.<\/li>\n<\/ul>\n<p>Se o seu formul\u00e1rio n\u00e3o permite programar no servidor, h\u00e1 caminhos sem c\u00f3digo: o widget para formul\u00e1rios, os pop-ups com verifica\u00e7\u00e3o, o n8n e o <a href=\"https:\/\/www.verificaremails.com\/pt-br\/como-usar-o-zapier-para-verificacao-de-e-mail\/\">Zapier para verificar e-mails<\/a>. Para conferir alguns endere\u00e7os soltos sem cadastro, use o <a href=\"https:\/\/www.verificaremails.com\/pt-br\/\">verificador de e-mail gratuito<\/a> da p\u00e1gina inicial.<\/p>\n<h2>Como a API verifica um e-mail sem enviar mensagem?<\/h2>\n<p>A API faz mais de 25 verifica\u00e7\u00f5es por endere\u00e7o. Come\u00e7a pela sintaxe e pelo dom\u00ednio, consulta os registros MX para saber qual servidor recebe as mensagens e conversa com esse servidor via SMTP para perguntar se a caixa existe, sem chegar a enviar nada. Tamb\u00e9m identifica spam traps, endere\u00e7os descart\u00e1veis, contas de fun\u00e7\u00e3o e dom\u00ednios catch-all.<\/p>\n<p>A precis\u00e3o do VerificarEmails \u00e9 de 99,8 %, calculada sobre o hist\u00f3rico de verifica\u00e7\u00f5es realizadas. Para entender cada etapa em detalhe, veja <a href=\"https:\/\/www.verificaremails.com\/pt-br\/validar-recursos-do-servico-de-e-mail\/como-funciona-a-verificacao-de-e-mail\/\">como funciona a verifica\u00e7\u00e3o de e-mail<\/a>.<\/p>\n<h2>O que a API de valida\u00e7\u00e3o devolve?<\/h2>\n<p>Para cada endere\u00e7o, a API devolve um resultado principal e marcas complementares. No VerificarEmails, os resultados s\u00e3o quatro: seguro, inv\u00e1lido, arriscado e desconhecido. As marcas dizem, por exemplo, se o endere\u00e7o \u00e9 descart\u00e1vel, uma conta de fun\u00e7\u00e3o ou de um dom\u00ednio catch-all. Os nomes exatos dos campos da resposta est\u00e3o na documenta\u00e7\u00e3o.<\/p>\n<div style=\"overflow-x:auto\">\n<table>\n<thead>\n<tr>\n<th>Resultado<\/th>\n<th>O que significa<\/th>\n<th>O que fazer<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Seguro<\/td>\n<td>O endere\u00e7o passou nas verifica\u00e7\u00f5es e pode receber e-mails.<\/td>\n<td>Aceite e salve normalmente.<\/td>\n<\/tr>\n<tr>\n<td>Inv\u00e1lido<\/td>\n<td>A sintaxe est\u00e1 errada, o dom\u00ednio n\u00e3o recebe e-mails ou a caixa n\u00e3o existe.<\/td>\n<td>No formul\u00e1rio, pe\u00e7a para a pessoa corrigir. Na lista, remova.<\/td>\n<\/tr>\n<tr>\n<td>Arriscado<\/td>\n<td>O endere\u00e7o pode existir, mas n\u00e3o d\u00e1 para confirmar com seguran\u00e7a. \u00c9 o caso dos dom\u00ednios catch-all, que aceitam qualquer endere\u00e7o.<\/td>\n<td>Aceite com cautela: marque o contato, confirme com double opt-in e acompanhe os bounces.<\/td>\n<\/tr>\n<tr>\n<td>Desconhecido<\/td>\n<td>O servidor de e-mail n\u00e3o respondeu ou bloqueou a verifica\u00e7\u00e3o.<\/td>\n<td>N\u00e3o bloqueie. Aceite e verifique de novo mais tarde.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h3>Marcas complementares<\/h3>\n<ul>\n<li><strong>Descart\u00e1vel:<\/strong> endere\u00e7o de um servi\u00e7o de e-mail tempor\u00e1rio. Em cadastros com teste gr\u00e1tis, cupom ou material para download, vale pedir outro endere\u00e7o.<\/li>\n<li><strong>Conta de fun\u00e7\u00e3o:<\/strong> endere\u00e7os gen\u00e9ricos, como contato@ ou vendas@. Servem para contatos B2B, mas costumam ser lidos por v\u00e1rias pessoas; avalie se fazem sentido numa campanha de marketing.<\/li>\n<li><strong>Catch-all:<\/strong> o dom\u00ednio aceita qualquer endere\u00e7o, ent\u00e3o n\u00e3o d\u00e1 para confirmar a caixa espec\u00edfica. Por isso o resultado \u00e9 arriscado.<\/li>\n<li><strong>Caixa cheia:<\/strong> a caixa existe, mas n\u00e3o aceita mensagens no momento. Verifique de novo mais tarde antes de remover o contato.<\/li>\n<li><strong>Desativado:<\/strong> a conta foi desativada. Tire o endere\u00e7o da lista de envio.<\/li>\n<\/ul>\n<h2>Valida\u00e7\u00e3o em tempo real ou em massa: qual usar?<\/h2>\n<p>Use a valida\u00e7\u00e3o em tempo real quando os endere\u00e7os chegam um por vez, como num formul\u00e1rio: a resposta leva de 1 a 2 segundos. Use a valida\u00e7\u00e3o em massa para listas inteiras enviadas em arquivo, que levam de 30 a 120 minutos conforme o tamanho. O ideal \u00e9 usar as duas: uma na entrada e outra na limpeza peri\u00f3dica.<\/p>\n<div style=\"overflow-x:auto\">\n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>Tempo real<\/th>\n<th>Em massa<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Quando usar<\/td>\n<td>Formul\u00e1rios, checkout, CRM<\/td>\n<td>Importa\u00e7\u00f5es, listas antigas, antes de campanhas<\/td>\n<\/tr>\n<tr>\n<td>Como funciona<\/td>\n<td>Uma chamada \u00e0 API por endere\u00e7o<\/td>\n<td>Envio de uma lista em arquivo (CSV ou Excel) pelo painel<\/td>\n<\/tr>\n<tr>\n<td>Tempo<\/td>\n<td>De 1 a 2 segundos por endere\u00e7o<\/td>\n<td>De 30 a 120 minutos, conforme o tamanho da lista<\/td>\n<\/tr>\n<tr>\n<td>Uso do resultado<\/td>\n<td>Decidir na hora se o cadastro segue<\/td>\n<td>Separar a lista por resultado antes de enviar<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Como integrar a API para validar e-mail, passo a passo?<\/h2>\n<p>A integra\u00e7\u00e3o tem cinco passos: criar a conta, pegar a chave de API, chamar a API a partir do seu servidor, definir o que fazer com cada resultado e testar antes de publicar. Em formul\u00e1rios, a chamada \u00e9 individual e em tempo real; para listas inteiras, envie o arquivo (CSV ou Excel) pelo painel.<\/p>\n<ol>\n<li><strong>Crie sua conta.<\/strong> O <a href=\"https:\/\/dashboard.verificaremails.com\/app\/public\/register\" target=\"_blank\" rel=\"nofollow\" >cadastro gratuito<\/a> inclui 100 verifica\u00e7\u00f5es de e-mail gr\u00e1tis, suficientes para testar a integra\u00e7\u00e3o com endere\u00e7os reais.<\/li>\n<li><strong>Pegue a chave de API.<\/strong> Entre no painel, copie a sua chave e guarde-a numa vari\u00e1vel de ambiente ou num cofre de segredos. Nunca a coloque no JavaScript que roda no navegador nem num reposit\u00f3rio p\u00fablico.<\/li>\n<li><strong>Chame a API a partir do seu servidor.<\/strong> Quando o formul\u00e1rio \u00e9 enviado, ou quando o campo de e-mail perde o foco, o seu back-end chama a API com o endere\u00e7o. A autentica\u00e7\u00e3o, os endpoints e os par\u00e2metros est\u00e3o na <a href=\"https:\/\/www.verificaremails.com\/docs\/pt\/\">documenta\u00e7\u00e3o em portugu\u00eas<\/a>.<\/li>\n<li><strong>Defina o que fazer com cada resultado.<\/strong> Siga a tabela acima: s\u00f3 \u00abinv\u00e1lido\u00bb bloqueia o envio; \u00abarriscado\u00bb e \u00abdesconhecido\u00bb passam com uma marca. Salve o resultado junto com o contato.<\/li>\n<li><strong>Teste e acompanhe.<\/strong> Antes de publicar, teste um endere\u00e7o seu, um inv\u00e1lido de prop\u00f3sito e, se tiver, um de dom\u00ednio catch-all. Depois, acompanhe os erros, o tempo de resposta e quantos cadastros caem em cada resultado.<\/li>\n<\/ol>\n<p>Se a ideia \u00e9 desenvolver a valida\u00e7\u00e3o por conta pr\u00f3pria, sem uma API externa, veja o que envolve <a href=\"https:\/\/www.verificaremails.com\/pt-br\/como-criar-um-verificador-de-correio-eletronico\/\">criar o seu pr\u00f3prio verificador de e-mail<\/a>. Para conhecer todos os recursos e modos de uso, acesse a p\u00e1gina da <a href=\"https:\/\/www.verificaremails.com\/pt-br\/validar-recursos-do-servico-de-e-mail\/melhore-seu-marketing-por-e-mail-com-nossa-poderosa-api-de-validacao-de-e-mail\/\">API de valida\u00e7\u00e3o de e-mail<\/a>.<\/p>\n<h2>Quais s\u00e3o as boas pr\u00e1ticas ao usar a API?<\/h2>\n<p>As regras b\u00e1sicas s\u00e3o quatro: definir um timeout curto, nunca bloquear o cadastro quando a API n\u00e3o responde, tratar \u00abarriscado\u00bb e \u00abdesconhecido\u00bb de forma diferente de \u00abinv\u00e1lido\u00bb e proteger a chave de API. Assim a valida\u00e7\u00e3o filtra os endere\u00e7os ruins sem deixar o formul\u00e1rio lento e sem afastar clientes reais.<\/p>\n<ul>\n<li><strong>Timeout e plano B:<\/strong> a resposta costuma chegar em 1 a 2 segundos. Configure um limite de poucos segundos; se ele estourar, aceite o endere\u00e7o, marque-o como pendente e valide de novo depois.<\/li>\n<li><strong>N\u00e3o bloqueie sem motivo:<\/strong> s\u00f3 \u00abinv\u00e1lido\u00bb justifica impedir o envio do formul\u00e1rio. Mostre uma mensagem clara, como \u00abConfira o endere\u00e7o de e-mail\u00bb, em vez de um erro gen\u00e9rico.<\/li>\n<li><strong>\u00abArriscado\u00bb:<\/strong> aceite, mas marque o contato. Confirme o endere\u00e7o com double opt-in e acompanhe os bounces dos primeiros envios.<\/li>\n<li><strong>\u00abDesconhecido\u00bb:<\/strong> \u00e9 falta de resposta do servidor, n\u00e3o prova de que o endere\u00e7o \u00e9 ruim. Aceite e verifique de novo antes de incluir o contato numa campanha.<\/li>\n<li><strong>Uma chamada por endere\u00e7o:<\/strong> n\u00e3o chame a API a cada tecla digitada. Valide no envio do formul\u00e1rio ou quando o campo perde o foco, e reaproveite o resultado de endere\u00e7os verificados h\u00e1 pouco tempo.<\/li>\n<li><strong>Proteja o formul\u00e1rio contra rob\u00f4s:<\/strong> sem captcha ou limite de tentativas, um rob\u00f4 pode gastar as suas verifica\u00e7\u00f5es com endere\u00e7os falsos.<\/li>\n<li><strong>Dados pessoais:<\/strong> o e-mail \u00e9 um dado pessoal. Informe a finalidade no cadastro e, ao contratar um fornecedor, verifique como ele trata os dados conforme a LGPD. No VerificarEmails, os dados ficam em servidores na Uni\u00e3o Europeia, com comunica\u00e7\u00f5es cifradas e cumprimento do RGPD.<\/li>\n<\/ul>\n<h2>Como escolher uma API para validar e-mail?<\/h2>\n<p>Compare as APIs pelo que elas verificam, pela velocidade e pelo tratamento dos casos duvidosos, n\u00e3o s\u00f3 pelo pre\u00e7o. Uma boa API confere a caixa via SMTP, identifica catch-all, descart\u00e1veis e contas de fun\u00e7\u00e3o, responde em poucos segundos, documenta bem a resposta e explica onde os dados ficam guardados.<\/p>\n<ul>\n<li><strong>Verifica\u00e7\u00f5es:<\/strong> a API vai al\u00e9m da sintaxe e do MX e confere a caixa no servidor SMTP?<\/li>\n<li><strong>Casos duvidosos:<\/strong> ela separa \u00abarriscado\u00bb e \u00abdesconhecido\u00bb de \u00abinv\u00e1lido\u00bb, ou joga tudo no mesmo saco?<\/li>\n<li><strong>Tempo de resposta:<\/strong> \u00e9 compat\u00edvel com um formul\u00e1rio, ou seja, poucos segundos por endere\u00e7o?<\/li>\n<li><strong>Documenta\u00e7\u00e3o:<\/strong> endpoints, erros e limites de uso est\u00e3o bem explicados?<\/li>\n<li><strong>Teste gr\u00e1tis:<\/strong> d\u00e1 para testar com endere\u00e7os reais antes de pagar?<\/li>\n<li><strong>Dados:<\/strong> onde os endere\u00e7os ficam e por quanto tempo?<\/li>\n<\/ul>\n<p>Para uma compara\u00e7\u00e3o lado a lado, veja o <a href=\"https:\/\/www.verificaremails.com\/pt-br\/comparativo-ferramentas-verificacao-email\/\">comparativo de ferramentas de verifica\u00e7\u00e3o de e-mail<\/a>.<\/p>\n<h2>Perguntas frequentes<\/h2>\n<h3>Qual \u00e9 o formato de um endere\u00e7o de e-mail v\u00e1lido?<\/h3>\n<p>Um endere\u00e7o v\u00e1lido tem um nome de usu\u00e1rio, o sinal @ e um dom\u00ednio, como usuario@dominio.com. Formas como \u00abusuario.com\u00bb, \u00abusuario#dominio.com\u00bb ou \u00abusuario.dominio\u00bb s\u00e3o inv\u00e1lidas. O formato correto, por\u00e9m, n\u00e3o prova que a caixa existe: para isso, a API consulta o dom\u00ednio, os registros MX e o servidor SMTP.<\/p>\n<h3>A API de valida\u00e7\u00e3o envia algum e-mail ao destinat\u00e1rio?<\/h3>\n<p>N\u00e3o. A API conversa com o servidor de e-mail do dom\u00ednio para saber se a caixa aceita mensagens, mas n\u00e3o envia nada. O destinat\u00e1rio n\u00e3o recebe aviso nem mensagem de teste. Por isso a valida\u00e7\u00e3o pode ser feita antes do primeiro contato, no momento do cadastro ou antes de importar uma lista.<\/p>\n<h3>Quanto tempo a API leva para validar um e-mail?<\/h3>\n<p>Em tempo real, de 1 a 2 segundos por endere\u00e7o, o que permite usar a API em formul\u00e1rios sem deixar o cadastro lento. Listas enviadas em massa levam minutos, de 30 a 120 conforme o tamanho. Configure um timeout no seu c\u00f3digo para que uma resposta lenta nunca trave o formul\u00e1rio.<\/p>\n<h3>Posso testar a API de valida\u00e7\u00e3o de gra\u00e7a?<\/h3>\n<p>Sim. O cadastro gratuito no VerificarEmails inclui 100 verifica\u00e7\u00f5es de e-mail gr\u00e1tis, que servem para testar a integra\u00e7\u00e3o com endere\u00e7os reais. Se voc\u00ea quer conferir s\u00f3 alguns endere\u00e7os sem criar conta, o campo da p\u00e1gina inicial permite verificar um n\u00famero limitado deles, sem cadastro.<\/p>\n<h3>O que fazer quando a API devolve \u00abdesconhecido\u00bb?<\/h3>\n<p>N\u00e3o bloqueie o endere\u00e7o. \u00abDesconhecido\u00bb significa que o servidor de e-mail n\u00e3o respondeu ou bloqueou a verifica\u00e7\u00e3o, n\u00e3o que o endere\u00e7o seja ruim. Aceite o cadastro, marque o contato e verifique de novo mais tarde, antes de inclu\u00ed-lo numa campanha. Se o resultado se repetir, envie com cautela e acompanhe os bounces.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Uma API para validar e-mail confere sintaxe, dom\u00ednio, MX e SMTP em 1 a 2 segundos, sem enviar mensagem. Veja quando us\u00e1-la, o que cada resultado significa e como integr\u00e1-la passo a passo.<\/p>\n","protected":false},"author":3,"featured_media":5753,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1073,1071],"tags":[],"class_list":["post-5777","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-validador-de-correio-eletronico","category-verificar-e-mails"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/posts\/5777","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/comments?post=5777"}],"version-history":[{"count":0,"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/posts\/5777\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/media\/5753"}],"wp:attachment":[{"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/media?parent=5777"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/categories?post=5777"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.verificaremails.com\/pt-br\/wp-json\/wp\/v2\/tags?post=5777"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}