Email Validator: Validación
Validar emails
Valida hasta 50 direcciones en un comando. Se comprueban en paralelo y vuelven en el orden en que las enviaste.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailsRequiere el scope tools:validate en tu API key.
1 crédito por dirección distinta. Las direcciones repetidas se validan y se cobran una vez, y aparecen una vez en results.
Si tus créditos no cubren toda la lista, no se valida nada: recibes INSUFFICIENT_CREDITS con cuántos necesitas y cuántos tienes.
Argumentos
emailsstring[]obligatorioDe 1 a 50 direcciones.
p. ej.
["ana@acme.com", "jhon@gmial.com"]
Inicio 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);Respuesta
{
"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 de la respuesta
resultsUn resultado por dirección distinta, en el orden en que las enviaste.
count / valid_count / invalid_countCuántas se comprobaron, y cuántas resultaron válidas e inválidas.
credits_usedCréditos consumidos por este comando.
results[].emailLa dirección, sin espacios y en minúsculas.
results[].validtruesolo cuando todas las comprobaciones pasaron.Provider TypeyEmail Provider Detectionson informativas y nunca lo vuelvenfalse.results[].checks[].checkEl nombre de la comprobación. Consulta Comprobaciones más abajo.
results[].checks[].statusPassedoFailed.results[].checks[].detailsUna frase que explica el resultado, lista para mostrar a un usuario.
results[].checks[].fullResponseSolo en
Email Deliverability: la respuesta exacta del servidor del buzón.results[].checks[].providerId / providerNameSolo en
Email Provider Detection: el proveedor de correo que aloja el dominio.
Listas grandes
Para miles de direcciones, llama a este comando en bloques de 50, uno tras otro, o sube el archivo en el dashboard (Email Validator → Lists): se valida en segundo plano y recibes un email con el CSV cuando termina.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_API_KEYLa API key no existe, fue revocada o se desactivó en el dashboard.
- 429
RATE_LIMITEDMás de 75 solicitudes/s o 75 simultáneas para la misma IP + API key. Espera el número de segundos indicado en Retry-After.
- CMD
MISSING_SCOPELa API key no tiene `tools:validate`.
- CMD
INVALID_ARGSUn argumento no es válido: falta el email (o el dominio, en `check_disposable`), más de 50 emails, una dirección de más de 254 caracteres, limit fuera de rango…
- CMD
INSUFFICIENT_CREDITSNo tienes suficientes créditos para todo el comando (créditos de validación para `validate_*`, créditos de disposable para `check_disposable`). No se comprobó nada y no se cobró nada.
- CMD
CREDITS_UNAVAILABLENo se pudieron leer tus créditos en este momento. No se cobró nada. Inténtalo de nuevo.
- CMD
NO_SERVERS_AVAILABLENo hay ningún servidor de validación disponible ahora mismo. No se cobró nada. Inténtalo de nuevo en breve.
- CMD
VALIDATION_FAILEDLos servidores de validación no respondieron a tiempo. Se devolvieron tus créditos. Inténtalo de nuevo.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.