# Ověření jedné adresy

> Ověřte jednu e-mailovou adresu ve webovém rozhraní nebo přes API, zvolte rychlý, nebo úplný režim a pomocí ověření zachyťte špatné adresy už při registraci.

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

| Režim | Kontroly | K čemu slouží |
| --- | --- | --- |
| `fast` (výchozí) | Syntaxe, MX záznamy, stáří domény, jednorázové, rolové, bezplatné a náhodně vypadající adresy | Registrační formuláře a vše, na co čeká člověk. |
| `full` | Vše z `fast` a navíc připojení k poštovnímu serveru příjemce a kontrola schránky: doručitelnost, deaktivace, plná schránka a catch-all | Čištění adres před důležitou rozesílkou, když na pár sekundách navíc nezáleží. |

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í](/cs/docs/email-verification/results/).

## Ověřte adresu

**Webové rozhraní**

  1. **Otevřete Email Verification.** Přejděte do **Email Verification → Emails** a vyberte **Verify Email**.

  2. **Zadejte adresu.** Napište ji do pole **Email** a vyberte **Verify Email**. Webové rozhraní používá režim `fast`.

  3. **Otevřete výsledek.** Adresa se objeví v seznamu s údaji **Status**, **Result**, **Risk**, **Score**, datem **Created** a počtem dní do vypršení (**Expiring**). Výběrem adresy zobrazíte všechny jednotlivé kontroly, například **Valid Syntax**, **Disposable**, **Role Account** a **Has MX Records**.

  Pokud chcete zkontrolovat mnoho adres najednou, [ověřte místo toho seznam](/cs/docs/email-verification/lists/).

**API**

  Zavolejte endpoint [Ověření adresy](/cs/docs/api-reference/email-verifications/verify/) s adresou a volitelně s režimem:

```bash
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" }'
```

  Výsledek přijde v odpovědi:

```json
{
  "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"
}
```

  V režimu `fast` mají kontroly schránky (`deliverable`, `disabled`, `inbox_full`, `catch_all` a `smtp_connect`) hodnotu `null`, protože se neprováděly.

  | Stav | Kdy |
  | --- | --- |
  | `200` | Adresa byla ověřena. Patří sem i chybně utvořené adresy, které se vracejí s `result: "invalid"`. |
  | `400` | Chybí `email`, nebo `mode` není `fast` ani `full`. |
  | `402` | Workspace má méně než 5 kreditů. |

  Každé úspěšné ověření také vyvolá událost `email_verification.created`. Viz [Typy událostí](/cs/docs/webhooks/event-types/).

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

```javascript title="verify-signup.js"
  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í

  - [Výsledky ověření](/cs/docs/email-verification/results/): Co znamenají jednotlivé výsledky, rizika a kontroly.
  - [Ověření seznamu](/cs/docs/email-verification/lists/): Zkontrolujte až 10 000 adres najednou.

---
Zdroj: https://emailit.com/cs/docs/email-verification/single/