Ověřování e-mailů
Ověřte jednu adresu v reálném čase.
Ověření adresy
Ověří jednu e-mailovou adresu a vrátí výsledek v odpovědi. Každé ověření stojí 5 kreditů, které se naúčtují před spuštěním kontroly. Pokud chcete ověřit mnoho adres najednou, vytvořte seznam k ověření. Vyžaduje API klíč s oprávněním full.
/email-verificationsTělo požadavku
emailstringPovinnéAdresa, kterou chcete ověřit. Hodnota, která není platnou adresou, také vrátí 200, a to s result: "invalid" a skóre 0, a ověření se naúčtuje.
modestringfast (výchozí) kontroluje syntaxi, jednorázové a rolové adresy, bezplatné poskytovatele, nesmyslné adresy, MX záznamy a stáří domény. full se navíc připojí k poštovnímu serveru příjemce a zkontroluje, jestli schránka existuje, jestli je deaktivovaná nebo plná a jestli doména přijímá všechny adresy. Schránku může potvrdit jen režim full. V režimu fast mají kontroly schránky hodnotu null. Když je poštovní server pomalý, může full trvat až zhruba 40 sekund, takže časový limit klienta nastavte výš.
Odpověď
Vrací 200 OK s objektem email_verification. Emailit také odešle webhookovou událost email_verification.created.
| Stav | Kdy |
|---|---|
400 |
Chybí email, nebo mode není fast ani full (standardní chyba validace). |
402 |
Workspace už nemá k dispozici 5 kreditů. Tělo odpovědi je {"error": {"message": "…", "code": 402}}. |
Výsledek
result |
Význam |
|---|---|
safe |
full: poštovní server schránku přijal a vymyšlenou adresu ve stejné doméně odmítl. fast: žádná kontrola neselhala a skóre je 70 nebo vyšší; schránka se nekontrolovala. |
role |
Rolová adresa, například info@ nebo support@. V režimu full byla potvrzena i schránka. |
catch_all |
Doména přijímá poštu pro jakoukoli adresu, takže schránku nelze potvrdit. Jen v režimu full. |
unknown |
Žádná jasná odpověď: poštovní server kontrolu zablokoval nebo odložil, neodpověděl, případně selhal dotaz do DNS. V režimu fast také tehdy, když žádná kontrola neselhala, ale skóre je nižší než 70. |
inbox_full |
Schránka je plná. Jen v režimu full. |
disabled |
Schránka existuje, ale je deaktivovaná. Jen v režimu full. |
disposable |
Doména patří službě pro jednorázové e-maily. |
invalid |
Syntaxe je neplatná, doména nemá MX záznamy nebo poštovní server oznámil, že schránka neexistuje. |
Pořadí, ve kterém je Emailit uplatňuje, najdete na stránce Výsledky ověření.
Skóre a riziko
score nabývá hodnot od 0 do 100; adresy, které nemohou přijímat poštu, mají skóre 0. risk je high u invalid, disabled a disposable a medium u catch_all, inbox_full a unknown (high, pokud je jejich skóre pod 50). U safe a role se řídí skóre: low od 80, medium od 50 a high pod 50. Viz Skóre.
Pole
statusstringcompleted u jednotlivých ověření.
checksobjectJednotlivé kontroly: valid_syntax, disposable, role_account, free_email a gibberish (logické hodnoty), has_mx_records (logická hodnota, nebo null, pokud selhal dotaz do DNS), domain_age (stáří domény ve dnech, nebo null, pokud není známé) a kontroly režimu full: smtp_connect, deliverable, disabled, inbox_full a catch_all (v režimu fast mají hodnotu null, v režimu full také tehdy, když poštovní server nedal jasnou odpověď).
addressobjectAdresa rozdělená na mailbox, domain, suffix (část za +, nebo null) a root (adresa bez přípony).
did_you_meanstring | nullNavrhovaná oprava pravděpodobného překlepu, například ada@gmail.com místo ada@gmial.com.
mx_recordsobject[]MX záznamy domény, každý s poli priority a exchange.
{
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"catch_all": null,
"free_email": false,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957,
"gibberish": false
},
"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:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
}{
"error": {
"message": "Workspace has insufficient email credits for email verification. Each verification requires 5 credits.",
"code": 402
}
}