Validação
API de validação de email
Valide endereços de email com verificação completa de sintaxe, domínio e caixa de correio. Reduza devoluções, melhore a entregabilidade e proteja a sua plataforma contra spam.
GET
API de validação de email
Início rápido
Para fazer um pedido, forneça o seuapi_key único e o email que pretende verificar — nada mais é necessário:
Parâmetros de pedido
As suas credenciais pessoais de API. As chaves são limitadas por produto Cleariflow, pelo que uma
chave de validação de email não autorizará pedidos a, por exemplo, a API de geolocalização IP.
Flag opcional para desativar a autocorreção. Defina
auto_correct=false para a desligar.
Está ativada por predefinição.Parâmetros de resposta
As respostas são devolvidas como JSON compacto e padronizado.Correção sugerida quando é detetado um provável erro de escrita (por exemplo,
johnsmith@gmial.com => johnsmith@gmail.com). Vazio se não houver sugestão.
Avaliação da Cleariflow sobre se o endereço pode receber correio. Valores
possíveis:
DELIVERABLE, UNDELIVERABLE, UNKNOWN. DELIVERABLE exige verificação
SMTP bem-sucedida; se existirem registros MX mas o SMTP não confirmar a caixa (comum
em grandes provedores), o resultado é UNKNOWN. Todos os planos executam as mesmas
verificações; os gratuitos diferem apenas na quota mensal e nos limites de taxa (ver
códigos 422 e 429).Pontuação decimal de
0 a 0.99 que reflete a qualidade do endereço. Endereços
descartáveis ficam limitados a cerca de 0.05; sem confirmação SMTP, máximo 0.55.true quando o endereço corresponde ao padrão local@domain.tld.
Elementos em falta ou caracteres inválidos resultam em false.true se o domínio está na nossa lista de fornecedores de caixas de correio
descartáveis/temporárias (por exemplo, Mailinator, Yopmail).true se a parte local parece ser uma conta de função e não de um
indivíduo, por exemplo team@, sales@, info@.true se o domínio está configurado como
catch-all.true quando existem registos MX para o
domínio.true se a verificação
SMTP
for bem-sucedida. Se o SMTP falhar mas outras verificações passarem, o resultado pode ser
UNKNOWN. Não recomendamos bloquear registos ou submissões de formulários apenas com base em
falhas SMTP.Exemplos de pedidos
Exemplo: provável erro de escrita
Este exemplo mostra um pedido em que é detetado um provável erro de escrita no endereço enviado. Mesmo quando é encontrado um provável erro de escrita, todas as outras verificações (por exemplo, email gratuito, domínio descartável) são realizadas sobre o endereço originalmente enviado — não sobre a correção sugerida.Exemplo: formato inválido
Este exemplo demonstra um endereço que falha a formatação básica. Quandois_valid_format é false, verificações subsequentes (por exemplo, is_free_email,
is_role_email) são ignoradas e reportadas como false.
Carregamento em massa (CSV)
Prefere não chamar a API diretamente? Utilize o carregador em massa CSV — os resultados serão enviados por email assim que o processamento terminar. Ao carregar um CSV, siga estas orientações:- Coloque os endereços de email na primeira coluna.
- Elimine quaisquer linhas em branco.
- Utilize um endereço por linha.
- Limite os ficheiros a um máximo de 50.000 linhas.