Email Validator: Validación
Validar email
Comprueba una dirección antes de enviarle: formato, dominio, MX, proveedores temporales, errores tipográficos, spam traps y si el buzón existe de verdad.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailRequiere el scope tools:validate en tu API key.
Usa 1 crédito de validación.
Argumentos
emailstringobligatorioLa dirección a comprobar. Hasta 254 caracteres.
p. ej.
"ana@acme.com"
Inicio 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);Respuesta
{
"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 de la respuesta
emailLa dirección, sin espacios y en minúsculas.
validtruesolo cuando todas las comprobaciones pasaron.Provider TypeyEmail Provider Detectionson informativas y nunca lo vuelvenfalse.checks[].checkEl nombre de la comprobación. Consulta Comprobaciones más abajo.
checks[].statusPassedoFailed.checks[].detailsUna frase que explica el resultado, lista para mostrar a un usuario.
checks[].fullResponseSolo en
Email Deliverability: la respuesta exacta del servidor del buzón.checks[].providerId / providerNameSolo en
Email Provider Detection: el proveedor de correo que aloja el dominio.
Comprobaciones
Se ejecutan en este orden y se detienen antes cuando no tiene sentido seguir (sin MX, formato incorrecto…).
Format ValidationLa dirección tiene un formato válido. Si falla, no se ejecuta nada más.
Local Part ValidationLa parte antes de
@cumple la RFC 5322 (longitud, puntos, caracteres).Role-based Email CheckInformativa: indica si es una dirección de equipo como
info@oadmin@. Nunca falla.No-reply Email CheckFalla con
noreply@y direcciones similares, que no leen lo que reciben.Temporary Email CheckFalla con proveedores desechables y temporales.
Misspelled Domain CheckFalla con errores tipográficos comunes de grandes proveedores (
gmial.com,hotmial.com…) y sugiere el correcto.Spam Trap CheckFalla con dominios conocidos como spam traps.
Provider TypeInformativa: proveedor gratuito/personal o dominio corporativo.
Domain ValidationEl dominio existe y tiene registros MX.
Null MX CheckFalla cuando el dominio declara que no acepta correo (RFC 7505).
Email Provider DetectionInformativa: el proveedor del buzón, cuando lo conocemos.
Email DeliverabilityPreguntamos al servidor del buzón si la dirección existe, sin enviar nada. Solo se ejecuta cuando pasaron todas las comprobaciones anteriores.
Catch-all Mail Exchanger CheckSolo para dominios corporativos. Falla cuando el servidor acepta cualquier dirección, así que no se puede confirmar el buzón.
Usar el resultado
Bloquea el registroCuando
validseafalse, muestra al usuario losdetailsde la primera comprobación fallida.Sugiere la correcciónMisspelled Domain Checktrae la dirección corregida endetails: ofrécela con un clic.Catch-allUna comprobación de catch-all fallida significa que el servidor acepta cualquier cosa. La dirección puede existir, pero nadie puede probarlo antes de enviar.
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.