Email Validator: Disposable
Verificar desechable
Te dice en milisegundos si una dirección o un dominio es desechable o de alto riesgo, para que puedas bloquear registros falsos. No habla con el servidor del buzón: para eso usa Validate Email.
https://g.sendcorex.com/v1/tool/validatecommand: check_disposableRequiere el scope tools:validate en tu API key.
Usa 1 crédito de disposable (no un crédito de validación). A los planes ilimitados nunca se les cobra.
Envía email o domain. Con un email, también se comprueba la reputación de fraude de la dirección.
Argumentos
emailstringopcionalLa dirección a comprobar. Hasta 254 caracteres.
p. ej.
"john@mailinator.com"domainstringopcionalSolo el dominio, cuando no tienes la dirección completa.
p. ej.
"mailinator.com"
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "check_disposable",
args: {
email: "john@mailinator.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": "check_disposable",
"id": "0",
"type": "SUCCESS",
"took_ms": 2,
"data": {
"email": "john@mailinator.com",
"domain": "mailinator.com",
"is_disposable": true,
"high_risk": true,
"code": "fully_confirmed",
"reason": "Confirmed",
"checks": [
{
"check": "Domain Blocklist Match",
"status": "Failed",
"details": "Domain found in known disposable list"
}
],
"unlimited": false,
"remaining_credits": 4999
}
}
]
}Campos de la respuesta
emailLa dirección que enviaste, sin espacios y en minúsculas.
nullcuando solo enviaste undomain.domainEl dominio que se comprobó.
is_disposabletruepara proveedores temporales/desechables. Bloquea el registro.high_risktruecuando la dirección es desechable O ya fue marcada por fraude en Sendcorex. Bloquéala o envíala a revisión.codefully_confirmedcuando se encontró algo,clearcuando no.reasonUna explicación breve del veredicto.
checksLas comprobaciones que se ejecutaron (
check,status,details). Consulta Comprobaciones más abajo.remaining_creditsCréditos de disposable restantes tras esta comprobación.
nullen un plan ilimitado.unlimitedtrueen un plan ilimitado.
Comprobaciones
De la más barata a la más lenta. Un dominio en la blocklist responde enseguida, sin ninguna consulta DNS.
Email Reputation CheckSolo aparece cuando falla: la dirección fue marcada por fraude en Sendcorex. Activa
high_risk, nois_disposable.Domain Blocklist MatchEl dominio es un proveedor desechable conocido. Cuando falla, no se ejecuta nada más: la respuesta vuelve enseguida.
MX Record CheckEl dominio está alojado en infraestructura usada por proveedores desechables, aunque todavía no esté en ninguna lista.
MX Record PresentInformativa: el dominio tiene registros MX. Un dominio sin MX no puede recibir correo (a menudo es un error tipográfico), pero eso solo no lo vuelve desechable.
Usar el resultado
Formularios de registroLlámalo antes de crear la cuenta. Cuando
is_disposableseatrue, pide otra dirección.Alto riesgohigh_risksinis_disposablees un buzón real marcado por fraude en Sendcorex. Bloquéalo o retén la cuenta para revisarla.Disposable vs. Validate EmailEsta comprobación es instantánea y barata. Validate Email además pregunta al servidor del buzón si la dirección existe, lo que tarda segundos: úsalo 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
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.