Email Validator: Validação
Validar email
Verifique um endereço antes de enviar para ele: formato, domínio, MX, provedores temporários, erros de digitação, spam traps e se a caixa realmente existe.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailRequer o escopo tools:validate na sua API key.
Usa 1 crédito de validação.
Argumentos
emailstringobrigatórioO endereço a verificar. Até 254 caracteres.
ex.:
"ana@acme.com"
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "validate_email",
args: {
email: "ana@acme.com"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Resposta
{
"type": "SUCCESS",
"results": [
{
"command": "validate_email",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"email": "ana@acme.com",
"valid": true,
"checks": [
{
"check": "Format Validation",
"status": "Passed",
"details": "Valid email format"
},
{
"check": "Local Part Validation",
"status": "Passed",
"details": "Local part is RFC compliant"
},
{
"check": "Role-based Email Check",
"status": "Passed",
"details": "Not a role-based address"
},
{
"check": "No-reply Email Check",
"status": "Passed",
"details": "Not a no-reply address"
},
{
"check": "Temporary Email Check",
"status": "Passed",
"details": "Not a temporary email"
},
{
"check": "Misspelled Domain Check",
"status": "Passed",
"details": "Correct"
},
{
"check": "Spam Trap Check",
"status": "Passed",
"details": "Not a spam trap"
},
{
"check": "Provider Type",
"status": "Passed",
"details": "Corporate or custom domain"
},
{
"check": "Domain Validation",
"status": "Passed",
"details": "Domain is valid and has MX records"
},
{
"check": "Null MX Check",
"status": "Passed",
"details": "Domain accepts email"
},
{
"check": "Email Provider Detection",
"status": "Passed",
"details": "Domain is hosted on a known provider: Google Workspace",
"providerId": 1,
"providerName": "Google Workspace"
},
{
"check": "Email Deliverability",
"status": "Passed",
"details": "Mailbox exists",
"fullResponse": "250 2.1.5 OK"
},
{
"check": "Catch-all Mail Exchanger Check",
"status": "Passed",
"details": "Mail exchanger correctly rejects nonexistent addresses"
}
]
}
}
]
}Campos da resposta
emailO endereço, sem espaços e em minúsculas.
validtruesó quando todas as verificações passaram.Provider TypeeEmail Provider Detectionsão informativas e nunca o tornamfalse.checks[].checkO nome da verificação. Veja Verificações abaixo.
checks[].statusPassedouFailed.checks[].detailsUma frase explicando o resultado, pronta para mostrar a um usuário.
checks[].fullResponseSó em
Email Deliverability: a resposta exata do servidor da caixa.checks[].providerId / providerNameSó em
Email Provider Detection: o provedor de email que hospeda o domínio.
Verificações
Rodam nesta ordem e param cedo quando não faz sentido continuar (sem MX, formato ruim…).
Format ValidationO endereço tem um formato válido. Se falhar, nada mais roda.
Local Part ValidationA parte antes do
@segue a RFC 5322 (tamanho, pontos, caracteres).Role-based Email CheckInformativa: diz se é um endereço de equipe como
info@ouadmin@. Nunca falha.No-reply Email CheckFalha para
noreply@e endereços parecidos, que não leem o que recebem.Temporary Email CheckFalha para provedores descartáveis e temporários.
Misspelled Domain CheckFalha para erros comuns de digitação de grandes provedores (
gmial.com,hotmial.com…) e sugere o correto.Spam Trap CheckFalha para domínios conhecidos como spam traps.
Provider TypeInformativa: provedor gratuito/pessoal ou domínio corporativo.
Domain ValidationO domínio existe e tem registros MX.
Null MX CheckFalha quando o domínio declara que não aceita email (RFC 7505).
Email Provider DetectionInformativa: o provedor da caixa, quando o conhecemos.
Email DeliverabilityPerguntamos ao servidor da caixa se o endereço existe, sem enviar nada. Só roda quando todas as verificações acima passaram.
Catch-all Mail Exchanger CheckSó para domínios corporativos. Falha quando o servidor aceita qualquer endereço, então a caixa não pode ser confirmada.
Usando o resultado
Bloqueie o cadastroQuando
validforfalse, mostre ao usuário osdetailsda primeira verificação que falhou.Sugira a correçãoMisspelled Domain Checkvem com o endereço corrigido emdetails: ofereça com um clique.Catch-allUma verificação de catch-all reprovada significa que o servidor aceita qualquer coisa. O endereço pode existir, mas ninguém consegue provar isso antes de enviar.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
INVALID_API_KEYA API key não existe, foi revogada ou foi desativada no dashboard.
- 429
RATE_LIMITEDMais de 75 requisições/s ou 75 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.
- CMD
MISSING_SCOPEA API key não tem `tools:validate`.
- CMD
INVALID_ARGSUm argumento é inválido: email ausente (ou domínio, em `check_disposable`), mais de 50 emails, um endereço com mais de 254 caracteres, limit fora do intervalo…
- CMD
INSUFFICIENT_CREDITSVocê não tem créditos suficientes para o comando inteiro (créditos de validação para `validate_*`, créditos de disposable para `check_disposable`). Nada foi verificado e nada foi cobrado.
- CMD
CREDITS_UNAVAILABLENão foi possível ler seus créditos agora. Nada foi cobrado. Tente de novo.
- CMD
NO_SERVERS_AVAILABLENenhum servidor de validação está disponível agora. Nada foi cobrado. Tente de novo em instantes.
- CMD
VALIDATION_FAILEDOs servidores de validação não responderam a tempo. Seus créditos foram devolvidos. Tente de novo.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.