Události ověření
Jednotlivé adresy ověřené přes API a každá adresa ze seznamu k ověření, jakmile je hotová.
email_verification.created
Odesílá se, když ověříte jednu adresu přes endpoint Ověření adresy. Ověření je už dokončené a obsah události odpovídá odpovědi API. Adresy ze seznamů k ověření místo toho vyvolávají email_verification.updated.
Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.
Pole
event_idstringID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.
typestringVždy email_verification.created.
objectobjectOvěření, kterého se událost týká. Jeho pole jsou uvedena níže.
data.objectobjectStejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.
Objekt ověření
idstringID ověření (ev_…).
objectstringVždy email_verification.
emailstringOvěřovaná adresa.
statusstringcompleted, pokud se kontrola dokončila, jinak failed.
scoreintegerSkóre od 0 do 100.
riskstringlow, medium nebo high.
resultstringsafe, invalid, disposable, disabled, inbox_full, role nebo unknown. Viz Ověření adresy.
modestringfast, nebo full. Adresy ze seznamů se vždy kontrolují v režimu full.
checksobjectJednotlivé kontroly. Kontroly schránky smtp_connect, deliverable, disabled, inbox_full a catch_all mají v režimu fast hodnotu null.
addressobjectAdresa rozdělená na mailbox, domain, suffix (část za +) a root.
did_you_meanstring | nullNavrhovaná oprava pravděpodobného překlepu.
mx_recordsobject[]MX záznamy domény, každý s poli priority a exchange.
created_atstringKdy bylo ověření vytvořeno, ve formátu ISO 8601 s posunem vůči UTC.
updated_atstringKdy bylo ověření naposledy upraveno.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification.created",
"object": {
"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,
"free_email": false,
"gibberish": false,
"catch_all": null,
"smtp_connect": null,
"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:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
},
"data": {
"object": {
"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,
"free_email": false,
"gibberish": false,
"catch_all": null,
"smtp_connect": null,
"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:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
}
}
}email_verification.updated
Odesílá se, když Emailit dokončí ověření adresy ze seznamu k ověření, jednou pro každou adresu. Seznam s 10 000 adresami vyvolá 10 000 těchto událostí; pokud potřebujete vědět jen to, kdy je hotový celý seznam, sledujte místo toho email_verification_list.updated.
Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.
Pole
event_idstringID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.
typestringVždy email_verification.updated.
objectobjectOvěření, kterého se událost týká. Jeho pole jsou uvedena níže.
data.objectobjectStejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.
Objekt ověření
idstringID ověření (ev_…).
objectstringVždy email_verification.
emailstringOvěřovaná adresa.
statusstringcompleted, pokud se kontrola dokončila, jinak failed.
scoreintegerSkóre od 0 do 100.
riskstringlow, medium nebo high.
resultstringsafe, invalid, disposable, disabled, inbox_full, role nebo unknown. Viz Ověření adresy.
modestringfast, nebo full. Adresy ze seznamů se vždy kontrolují v režimu full.
checksobjectJednotlivé kontroly. Kontroly schránky smtp_connect, deliverable, disabled, inbox_full a catch_all mají v režimu fast hodnotu null.
addressobjectAdresa rozdělená na mailbox, domain, suffix (část za +) a root.
did_you_meanstring | nullNavrhovaná oprava pravděpodobného překlepu.
mx_recordsobject[]MX záznamy domény, každý s poli priority a exchange.
created_atstringKdy bylo ověření vytvořeno, ve formátu ISO 8601 s posunem vůči UTC.
updated_atstringKdy bylo ověření naposledy upraveno.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification.updated",
"object": {
"id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"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:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
},
"data": {
"object": {
"id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"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:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
}
}
}