Ověření jedné adresy

Tento návod ukazuje, jak zkontrolovat jednu e-mailovou adresu, buď ručně ve webovém rozhraní, nebo z vašeho kódu přes API. Popisuje také, jak ověřování použít v registračním formuláři, aby se překlepy a jednorázové adresy nedostaly do vašeho seznamu.

Než začnete

• Každé ověření stojí 5 kreditů. Zůstatek zkontrolujete v postranním panelu, nebo v Workspace›Billing.
• Pro API použijte API klíč s oprávněním Full Access. Klíče jen pro odesílání adresy ověřovat nemohou.

Rychlý a úplný režim

Oba režimy stojí stejně. full trvá déle, protože komunikuje s poštovním serverem příjemce, který může být pomalý nebo odpověď odmítnout. Někteří velcí poskytovatelé tyto kontroly blokují, takže full nemůže schránku vždy potvrdit. Co jednotlivé kontroly znamenají, popisuje stránka Výsledky ověření.

Ověřte adresu

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

Ověřujte adresy při registraci

Kontrola adresy v okamžiku, kdy ji někdo zadá, je nejlevnější způsob, jak udržet seznam čistý. Překlep zachycený při registraci se nikdy nestane nedoručením.

1. Volejte API ze svého serveru. API klíč nikdy nedávejte do kódu v prohlížeči. Adresu pošlete z obsluhy registrace v režimu fast.

2. Nastavte časový limit a při selhání registraci pusťte. Pokud je ověření pomalé, nebo vrátí chybu, registraci propusťte. Ztráta skutečného zákazníka stojí víc než jedna špatná adresa.

3. Reagujte na výsledek. Blokujte, co je zjevně špatně, u překlepů navrhněte opravu a vše ostatní propusťte.

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

Několik tipů:

• Využijte did_you_mean. U častých překlepů v doméně, například ada@gmial.com, obsahuje pravděpodobnou adresu ada@gmail.com. Zobrazte ji jako návrh, který osoba může přijmout.
• Rolové adresy rovnou neblokujte. Přes info@ nebo sales@ se často registrují malé firmy. Místo toho je označte.
• Každou adresu ověřujte jednou. Každé volání stojí kredity, takže ověřujte při odeslání formuláře, ne při každém stisku klávesy, a výsledek si uložte.

Související