Email Validator: Validação
Validar emails
Valide até 50 endereços em um comando. Eles são verificados em paralelo e voltam na ordem em que você os enviou.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailsRequer o escopo tools:validate na sua API key.
1 crédito por endereço distinto. Endereços repetidos são validados e cobrados uma vez, e aparecem uma vez em results.
Se seus créditos não cobrirem a lista inteira, nada é validado: você recebe INSUFFICIENT_CREDITS com quantos precisa e quantos tem.
Argumentos
emailsstring[]obrigatório1 a 50 endereços.
ex.:
["ana@acme.com", "jhon@gmial.com"]
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "validate_emails",
args: {
emails: [
"ana@acme.com",
"jhon@gmial.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_emails",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"results": [
{
"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"
}
]
},
{
"email": "jhon@gmial.com",
"valid": false,
"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": "Failed",
"details": "Possible typo. Suggested correction: jhon@gmail.com"
},
{
"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": "Failed",
"details": "Invalid domain or no MX records"
}
]
}
],
"count": 2,
"valid_count": 1,
"invalid_count": 1,
"credits_used": 2
}
}
]
}Campos da resposta
resultsUm resultado por endereço distinto, na ordem em que você os enviou.
count / valid_count / invalid_countQuantos foram verificados, e quantos voltaram válidos e inválidos.
credits_usedCréditos usados por este comando.
results[].emailO endereço, sem espaços e em minúsculas.
results[].validtruesó quando todas as verificações passaram.Provider TypeeEmail Provider Detectionsão informativas e nunca o tornamfalse.results[].checks[].checkO nome da verificação. Veja Verificações abaixo.
results[].checks[].statusPassedouFailed.results[].checks[].detailsUma frase explicando o resultado, pronta para mostrar a um usuário.
results[].checks[].fullResponseSó em
Email Deliverability: a resposta exata do servidor da caixa.results[].checks[].providerId / providerNameSó em
Email Provider Detection: o provedor de email que hospeda o domínio.
Listas grandes
Para milhares de endereços, chame este comando em blocos de 50, um depois do outro, ou envie o arquivo no dashboard (Email Validator → Lists): ele é validado em segundo plano e você recebe um email com o CSV quando terminar.
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.