Návod
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 WorkspaceBilling.
- 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í v API) |
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 (webové rozhraní) |
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 |
Zjištění, jestli schránka existuje, například 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, obvykle několik sekund a nejvýše zhruba 40 sekund, protože komunikuje s poštovním serverem příjemce, který může být pomalý nebo odpověď odmítnout. Když odpověď odmítne, výsledek je unknown, ne odhad. Co jednotlivé kontroly znamenají, popisují stránky Jak funguje kontrola schránky a Výsledky ověření.
Ověřte adresu
-
Otevřete Email Verification. Přejděte do Email VerificationEmails a vyberte Verify Email.
-
Zadejte adresu. Napište ji do pole Email a vyberte Verify Email. Webové rozhraní používá režim
full, takže kontroluje i schránku. -
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 Deliverable, Catch-all, Valid Syntax, Disposable, Role Account a Has MX Records. U kontroly, na kterou poštovní server jasně neodpověděl, se zobrazí Unknown.
Pokud chcete zkontrolovat mnoho adres najednou, ověřte místo toho seznam.
Zavolejte endpoint Ověření adresy s adresou a volitelně s režimem:
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:
{
"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. V režimu full má kontrola schránky hodnotu null, když poštovní server nedal jasnou odpověď.
| 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í.
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.
-
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. -
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.
-
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říkladada@gmial.com, obsahuje pravděpodobnou adresuada@gmail.com. Zobrazte ji jako návrh, který osoba může přijmout. - Rolové adresy rovnou neblokujte. Přes
info@nebosales@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.