Verificar una sola dirección

Esta guía explica cómo comprobar una dirección de email, a mano en el panel o desde tu código con la API. También explica cómo usar la verificación en un formulario de registro para frenar las erratas y las direcciones de usar y tirar antes de que lleguen a tu lista.

Antes de empezar

• Cada verificación cuesta 5 créditos. Consulta tu saldo en la barra lateral o en Workspace›Billing.
• Para la API, usa una clave de API con Full Access. Las claves solo de envío no pueden verificar direcciones.

Modo rápido y modo completo

Los dos modos cuestan lo mismo. full tarda más porque se comunica con el servidor de correo del destinatario, que puede ser lento o negarse a responder. Algunos proveedores grandes bloquean estas comprobaciones, así que full no siempre puede confirmar un buzón. Consulta Resultados de la verificación para saber qué significa cada comprobación.

Verificar una dirección

curl https://api.emailit.com/v2/email-verifications \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "mode": "full" }'

{
  "id": "ev_6Hq2Lm9Tx4Pz",
  "object": "email_verification",
  "email": "ada@example.com",
  "status": "completed",
  "score": 100,
  "risk": "low",
  "result": "safe",
  "mode": "full",
  "checks": {
    "valid_syntax": true,
    "disposable": false,
    "role_account": false,
    "inbox_full": false,
    "deliverable": true,
    "disabled": false,
    "free_email": false,
    "gibberish": false,
    "catch_all": false,
    "smtp_connect": true,
    "has_mx_records": true,
    "domain_age": 10957
  },
  "address": {
    "mailbox": "ada",
    "domain": "example.com",
    "suffix": null,
    "root": "ada@example.com"
  },
  "did_you_mean": null,
  "mx_records": [
    { "priority": 10, "exchange": "mx1.example.com" }
  ],
  "created_at": "2026-10-01T10:24:11Z",
  "updated_at": "2026-10-01T10:24:11Z"
}

Verificar las direcciones en el registro

Comprobar una dirección cuando alguien la escribe es la forma más barata de mantener limpia una lista. Una errata detectada en el registro nunca se convierte en un rebote.

1. Llama a la API desde tu servidor. No pongas nunca tu clave de API en el código del navegador. Envía la dirección desde el gestor de registro de tu servidor, en modo fast.

2. Fija un tiempo de espera y deja pasar en caso de fallo. Si la verificación es lenta o devuelve un error, deja que el registro continúe. Perder a un cliente real cuesta más que una dirección incorrecta.

3. Actúa según el resultado. Bloquea lo que está claramente mal, sugiere correcciones para las erratas y deja pasar todo lo demás.

export async function checkSignupEmail(email) {
  const controller = new AbortController();
  const timer = setTimeout(() => controller.abort(), 5000);

  try {
    const res = await fetch('https://api.emailit.com/v2/email-verifications', {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ email, mode: 'fast' }),
      signal: controller.signal,
    });
    if (!res.ok) return { ok: true }; // fail open

    const verification = await res.json();

    if (verification.result === 'invalid') {
      return {
        ok: false,
        message: verification.did_you_mean
          ? `Did you mean ${verification.did_you_mean}?`
          : 'Please check your email address.',
      };
    }
    if (verification.result === 'disposable') {
      return { ok: false, message: 'Please use a permanent email address.' };
    }

    // Accept the address, but offer a correction if one looks likely.
    return { ok: true, suggestion: verification.did_you_mean };
  } catch {
    return { ok: true }; // timeout or network error: fail open
  } finally {
    clearTimeout(timer);
  }
}

Algunos consejos:

• Usa did_you_mean. Para las erratas habituales en el dominio, como ada@gmial.com, contiene la dirección probable, ada@gmail.com. Muéstrala como una sugerencia que la persona puede aceptar.
• No bloquees directamente las direcciones de rol. info@ o sales@ es a menudo la forma en que se registran las pequeñas empresas. Márcalas en su lugar.
• Verifica cada dirección una sola vez. Cada llamada cuesta créditos, así que verifica al enviar el formulario, no con cada pulsación de tecla, y guarda el resultado.

Ver también