Einzelne Adresse verifizieren

Diese Anleitung zeigt, wie Sie eine einzelne E-Mail-Adresse prüfen, entweder von Hand in der Weboberfläche oder aus Ihrem Code per API. Außerdem erfahren Sie, wie Sie die Verifizierung in einem Anmeldeformular nutzen, um Tippfehler und Wegwerf-Adressen abzufangen, bevor sie in Ihre Liste gelangen.

Voraussetzungen

• Jede Verifizierung kostet 5 Credits. Ihr Guthaben sehen Sie in der Seitenleiste oder unter Workspace›Billing.
• Verwenden Sie für die API einen API-Schlüssel mit Full Access. Reine Sende-Schlüssel können keine Adressen verifizieren.

Schneller und vollständiger Modus

Beide Modi kosten gleich viel. full dauert länger, weil dieser Modus mit dem Mailserver des Empfängers kommuniziert, der langsam sein oder die Antwort verweigern kann. Einige große Anbieter blockieren diese Prüfungen, daher kann full ein Postfach nicht immer bestätigen. Was jede Prüfung bedeutet, erfahren Sie unter Verifizierungsergebnisse.

Adresse verifizieren

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"
}

Adressen bei der Registrierung verifizieren

Eine Adresse zu prüfen, während jemand sie eingibt, ist der günstigste Weg, eine Liste sauber zu halten. Ein Tippfehler, der bei der Registrierung auffällt, wird nie zum Bounce.

1. API von Ihrem Server aus aufrufen. Legen Sie Ihren API-Schlüssel nie in Browser-Code ab. Senden Sie die Adresse aus Ihrem Registrierungs-Handler, im Modus fast.

2. Timeout setzen und im Fehlerfall durchlassen. Wenn die Verifizierung langsam ist oder einen Fehler liefert, lassen Sie die Registrierung zu. Ein verlorener echter Kunde kostet mehr als eine schlechte Adresse.

3. Auf das Ergebnis reagieren. Blockieren Sie, was eindeutig falsch ist, schlagen Sie Korrekturen für Tippfehler vor und lassen Sie alles andere durch.

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);
  }
}

Einige Tipps:

• Nutzen Sie did_you_mean. Bei häufigen Tippfehlern in der Domain, etwa ada@gmial.com, enthält es die wahrscheinliche Adresse, ada@gmail.com. Zeigen Sie sie als Vorschlag an, den die Person übernehmen kann.
• Blockieren Sie Rollenadressen nicht pauschal. Über info@ oder sales@ registrieren sich kleine Unternehmen oft. Markieren Sie solche Adressen stattdessen.
• Verifizieren Sie jede Adresse nur einmal. Jeder Aufruf kostet Credits. Verifizieren Sie daher beim Absenden des Formulars, nicht bei jedem Tastendruck, und speichern Sie das Ergebnis.

Siehe auch