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.

POSThttps://g.sendcorex.com/v1/tool/validatecommand: check_disposable
i

Requiere el scope tools:validate en tu API key.

i

Usa 1 crédito de disposable (no un crédito de validación). A los planes ilimitados nunca se les cobra.

i

Envía email o domain. Con un email, también se comprueba la reputación de fraude de la dirección.

Argumentos

  • emailstringopcional

    La dirección a comprobar. Hasta 254 caracteres.

    p. ej. "john@mailinator.com"

  • domainstringopcional

    Solo 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

  • email

    La dirección que enviaste, sin espacios y en minúsculas. null cuando solo enviaste un domain.

  • domain

    El dominio que se comprobó.

  • is_disposable

    true para proveedores temporales/desechables. Bloquea el registro.

  • high_risk

    true cuando la dirección es desechable O ya fue marcada por fraude en Sendcorex. Bloquéala o envíala a revisión.

  • code

    fully_confirmed cuando se encontró algo, clear cuando no.

  • reason

    Una explicación breve del veredicto.

  • checks

    Las comprobaciones que se ejecutaron (check, status, details). Consulta Comprobaciones más abajo.

  • remaining_credits

    Créditos de disposable restantes tras esta comprobación. null en un plan ilimitado.

  • unlimited

    true en 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 Check

    Solo aparece cuando falla: la dirección fue marcada por fraude en Sendcorex. Activa high_risk, no is_disposable.

  • Domain Blocklist Match

    El dominio es un proveedor desechable conocido. Cuando falla, no se ejecuta nada más: la respuesta vuelve enseguida.

  • MX Record Check

    El dominio está alojado en infraestructura usada por proveedores desechables, aunque todavía no esté en ninguna lista.

  • MX Record Present

    Informativa: 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 registro

    Llámalo antes de crear la cuenta. Cuando is_disposable sea true, pide otra dirección.

  • Alto riesgo

    high_risk sin is_disposable es un buzón real marcado por fraude en Sendcorex. Bloquéalo o retén la cuenta para revisarla.

  • Disposable vs. Validate Email

    Esta 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.

  • 401INVALID_API_KEY

    La API key no existe, fue revocada o se desactivó en el dashboard.

  • 429RATE_LIMITED

    Má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.

  • CMDMISSING_SCOPE

    La API key no tiene `tools:validate`.

  • CMDINVALID_ARGS

    Un 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…

  • CMDINSUFFICIENT_CREDITS

    No 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.

  • CMDCREDITS_UNAVAILABLE

    No se pudieron leer tus créditos en este momento. No se cobró nada. Inténtalo de nuevo.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.