MailLandDocs
E-posta Doğrulama

Tekli E-posta Dogrulama

Sozdizimi, alan adi ve SMTP kontrolleriyle tek tek e-posta adreslerini gercek zamanli olarak dogrulayin

Gondermeden once bir e-posta adresini gercek zamanli olarak dogrulayin. MailLand 5 katmanli bir dogrulama hatti calistirir: sozdizimi kontrolu, yazim hatasi tespiti, tek kullanimlik alan adi tespiti, rol hesabi tespiti ve SMTP dogrulamasi.

Kimlik Dogrulama

API anahtarinizi X-API-Key basligina ekleyin:

X-API-Key: ml_pv_Ab3Kx9mN2pQ7rT4wL8yD...

Kimlik bilgisi, Api kanali etkinlestirilmis bir Validation urun kimlik bilgisi olmalidir.

Bir E-posta Dogrulama

POST https://api.mail.land/v1/validation/email
Dogrulama istegi
{
  "email": "[email protected]",
  "verify_smtp": true
}
AlanTipVarsayilanAciklama
emailstring-Dogrulanacak e-posta adresi (zorunlu)
verify_smtpbooltrueSMTP posta kutusu dogrulamasi yap
Validate an email
curl -X POST https://api.mail.land/v1/validation/email \
  -H "X-API-Key: ml_pv_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "verify_smtp": true }'

Yanit

Dogrulama yaniti
{
  "email": "[email protected]",
  "result": "Deliverable",
  "score": 95,
  "syntax": {
    "is_valid": true,
    "suggestion": null,
    "domain": "example.com",
    "local_part": "user",
    "has_typo": false,
    "typo_type": null,
    "typo_confidence": null
  },
  "disposable": {
    "is_disposable": false
  },
  "role": {
    "is_role_account": false
  },
  "mx": {
    "has_mx": true,
    "records": ["mx1.example.com", "mx2.example.com"],
    "accepts_mail": true
  },
  "smtp": {
    "can_connect": true,
    "is_deliverable": true,
    "is_catch_all": false,
    "has_full_inbox": false,
    "is_disabled": false,
    "reachability": "safe",
    "error_type": null,
    "error_message": null
  },
  "provider": {
    "name": "Unknown",
    "type": "unknown"
  },
  "cached": false,
  "verified_at": "2026-02-17T12:34:56Z"
}

Sonuc Tipleri

SonucPuan AraligiAciklama
Deliverable80–95Gecerli adres, SMTP ile teslim edilebilirligi onaylandi
Risky45–70Teslim edilebilir olabilir ancak risk faktorleri mevcut (catch-all, rol hesabi, dolu kutu)
Unknown30–50Belirlenemiyor (SMTP zaman asimi, baglanti hatasi)
Undeliverable0–25Teslim edilemez (tek kullanimlik, MX kaydi yok, devre disi posta kutusu; gecersiz sozdizimi = 0)
Invalid5 (sabit)Yuksek guvenilirlikli alan adi yazim hatasi (guven >=90%), bkz. syntax.suggestion

Puan Ayarlamalari

Temel puan, risk faktorlerine gore ayarlanir:

FaktorAyarlama
Rol hesabi (info@, admin@, vb.)-10
Catch-all sunucu-5

Dogrulama Hatti

MailLand her e-postayi 5 katmandan gecirir:

Sozdizimi dogrulamasi

RFC 5322 uyumlulugunu kontrol eder: gecerli format, yerel kisim (maksimum 64 karakter), alan adi (maksimum 255 karakter), toplam uzunluk (maksimum 320 karakter). Ayrica yaygin alan adi yazim hatalarini tespit eder.

Tek kullanimlik alan adi kontrolu

Alan adini bilinen gecici/tek kullanimlik e-posta saglayicilarinin veritabaniyla karsilastirir. Tek kullanimlik adresler dogrudan Undeliverable olarak isaretlenir.

Rol hesabi kontrolu

info@, admin@, support@, postmaster@ gibi rol tabanli adresleri tespit eder. Rol hesaplari teslim edilemez olarak isaretlenmez ancak guven puanini dusurur.

MX kaydi dogrulamasi

Alan adi icin MX kayitlarini arar. MX kaydi ve A kaydi yoksa e-posta Undeliverable olarak isaretlenir.

SMTP dogrulamasi

Posta sunucusuna baglanir ve posta kutusunun var olup olmadigini kontrol eder. verify_smtp degeri false ise bu adim atlanir.

Yazim Hatasi Tespiti

MailLand yaygin alan adi hatalari icin 3 katmanli yazim hatasi tespiti kullanir:

KatmanYontemOrnek
Tam eslemeBilinen yazim hatalarinin veritabanigmial.com → gmail.com
TLD duzeltmeUst duzey alan adi varyantlarigmail.co → gmail.com
Levenshtein mesafesiBulanik esleme (maksimum mesafe: 2)gmal.com → gmail.com

Bir yazim hatasi tespit edildiginde, syntax.suggestion alani duzeltilmis adresi icerir:

Yazim hatasi tespit edildi
{
  "email": "[email protected]",
  "result": "Invalid",
  "score": 5,
  "syntax": {
    "is_valid": true,
    "suggestion": "[email protected]",
    "domain": "gmial.com",
    "local_part": "user",
    "has_typo": true,
    "typo_type": "levenshtein",
    "typo_confidence": 95
  }
}

Yuksek guvenilirlikli yazim hatalari (%90+ guven) hatta erken asamada kisa devre yapilir: SMTP kontrolu yapilmaz ve kredi tuketilmez.

Saglayici Tespiti

MailLand, alan adlari ve MX kayitlarindan e-posta saglayicisini tanir:

SaglayiciTipTespit
GmailconsumerAlan adi eslesmesi
Outlook / Hotmail / LiveconsumerAlan adi eslesmesi
YahooconsumerAlan adi eslesmesi
iCloudconsumerAlan adi eslesmesi
ProtonMailconsumerAlan adi eslesmesi
Google WorkspacebusinessMX kayitlari (aspmx)
Microsoft 365businessMX kayitlari (outlook.com)
ZohobusinessMX kayitlari
MimecastbusinessMX kayitlari
ProofpointbusinessMX kayitlari

SMTP Kontrol Detaylari

smtp nesnesi detayli SMTP dogrulama sonuclarini icerir:

AlanTipAciklama
can_connectboolSMTP sunucusuna basariyla baglandi
is_deliverableboolPosta kutusu mevcut gorunuyor
is_catch_allboolSunucu tum adresleri kabul ediyor (guveni azaltir)
has_full_inboxboolPosta kutusu dolu (sonuc: Risky)
is_disabledboolPosta kutusu devre disi (sonuc: Undeliverable)
reachabilitystringKarar: safe, risky, invalid veya unknown
error_typestringSMTP kontrolu basarisiz olursa hata tipi
error_messagestringDetayli hata mesaji

SMTP Hata Tipleri

Hata TipiAciklama
TimeoutSMTP baglantisi zaman asimina ugradi
ConnectionFailedSunucuya baglanilamadi
BlacklistedDogrulama IP'si sunucu tarafindan engellendi
Socks5Proxy hatasi
AsyncSmtpErrorSMTP protokol hatasi
CancelledIstek iptal edildi
UnexpectedErrorBeklenmeyen hata

Krediler

Her dogrulama, aylik kotanizdan bir kredi tuketir. Belirli dogrulamalar ucretsizdir (kredi tuketilmez):

KosulUcretsiz
Tek kullanimlik e-posta alan adlariEvet
Yuksek guvenilirlikli alan adi yazim hatalari (%90+)Evet
SMTP hatalari (zaman asimi, baglanti hatasi, engellenmis)Evet
SMTP baglanti kurulamadi, sonuc bilinmiyorEvet
Onbellekteki sonuclarHayir (kredi ilk kontrolde tuketildi)

Kredi bakiyenizi kontrol edin:

GET https://api.mail.land/v1/validation/credits
Kredi bakiyesi
{
  "monthly_quota": 1000,
  "used": 450,
  "remaining": 550,
  "resets_at": "2026-03-01T00:00:00Z"
}

Krediler her ayin ilk gunu (UTC) otomatik olarak sifirlanir.

Onbellekleme

Dogrulama sonuclari gereksiz kontrolleri onlemek icin Redis'te onbelleklenir:

Sonuc TipiOnbellek Suresi
Deliverable48 saat
Risky24 saat
Undeliverable24 saat
Unknown6 saat

Onbellekteki yanitlarda cached: true degeri bulunur. Orijinal kredi, sonuc ilk hesaplandiginda tuketilmistir.

Hata Yanitlari

DurumKodAciklama
400INVALID_REQUESTEksik veya gecersiz istek govdesi
400INVALID_EMAIL_FORMATE-posta adresi gereklidir
402INSUFFICIENT_CREDITSAylik dogrulama kotasi asildi

Sonraki Adimlar

Bu sayfada