E-posta Doğrulama API Dokümanları

Başlarken

Tüm API istekleri, bir API anahtarı kullanarak kimlik doğrulaması gerektirir. API anahtarınızı kontrol panelinde bulabilirsiniz.

Başlık: "x-api-key: your-api-key"

Tek Doğrulama

Tek bir e-posta adresini veya etki alanını geçerlilik, tek kullanımlık durumu, gizlilik hizmetleri ve teslim edilebilirlik açısından doğrulayın.

Bitiş Noktası

GET /v1/verify

Parametreler

İsim	Tip	Gerekli	Açıklama
input	string	Evet	Doğrulanacak e-posta adresi veya alan adı (örneğin, test@example.com veya example.com)

Yanıt Alanları

Saha	Açıklama
valid	E-posta biçiminin doğru olup olmadığını gösterir
block	E-postanın engellenip engellenmeyeceğini belirtir (tek kullanımlık, privacy, applePrivateEmail, deliverable veya catch_all true ise true)
disposable	E-posta adresinin geçici veya tek kullanımlık bir e-posta adresi olup olmadığını belirler
privacy	Posta sunucusunun bir e-posta takma adı veya iletici kullanıp kullanmadığını belirler
applePrivateEmail	E-postanın bir Apple Özel e-posta adresi olup olmadığını belirtir
deliverable	Posta kutusunun var olup olmadığını ve e-posta alıp alamayacağını kontrol eder
domain	E-posta adresinin alan adı kısmı
email_address	E-posta adresi
catch_all	Etki alanının, alıcı adresinden bağımsız olarak gelen tüm e-postaları kabul eden bir tümünü yakala e-posta yapılandırmasına sahip olup olmadığını belirtir
mx_found	Etki alanının geçerli posta sunucularına (MX kayıtları) sahip olup olmadığını gösterir
remaining_credits	Hesabınızda kalan API kredisi sayısı

Kara Liste / Beyaz Liste: Yalnızca blok alanı liste üyeliğini yansıtır. Kara liste → blok: true; beyaz liste → blok: false; beyaz listede değil (etkinleştirildiğinde) → blok: true. Listelere göre engelleme yapıp yapmayacağınıza karar vermek için valid kullanmayın.

Örnek Yanıt

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "test@example.com",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Kod Örnekleri

curl "https://api.verify-email.app/v1/verify?input=test@example.com" \
  -H "X-API-Key: your-api-key"

Dene bakalım

API Anahtarı

Uç noktaları test etmek için bir API anahtarına ihtiyacınız vardır.

E-posta Adresi veya Alan Adı

Birlikte deneyin:

Toplu Doğrulama

Tek bir istekte birden fazla e-posta adresini veya etki alanını doğrulayın (maksimum 100 öğe).

Bitiş Noktası

POST /v1/verify/batch

Parametreler

İsim	Tip	Gerekli	Açıklama
inputs	array of strings	Evet	Doğrulanacak e-posta adresleri veya alan adları dizisi

Kod Örnekleri

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "test1@example.com",
      "test2@example.com"
    ]
  }'

Dene bakalım

API Anahtarı

Uç noktaları test etmek için bir API anahtarına ihtiyacınız vardır.

E-posta Adresleri veya Alan Adları

Farklı alan adları ile deneyin:

Yalnızca Teslim Edilebilir Kontrol

Harici API çağrıları olmadan MX ve SMTP doğrulamasını kullanarak hızlı e-posta teslim edilebilirlik kontrolü. Daha hızlı yanıt süreleri için yalnızca teslim edilebilirlikle ilgili alanları döndürür.

Bitiş Noktası

GET /v1/verify/deliverable

Parametreler

İsim	Tip	Gerekli	Açıklama
input	string	Evet	Teslim edilebilirliği kontrol etmek için e-posta adresi (örn. test@example.com). Bu uç nokta için yalnızca alan adı girişi desteklenmez.

Yanıt Alanları

Saha	Açıklama
valid	E-posta biçiminin doğru olup olmadığını gösterir
deliverable	Posta kutusunun var olup olmadığını ve e-posta alıp alamayacağını kontrol eder
mx_found	Etki alanının geçerli posta sunucularına (MX kayıtları) sahip olup olmadığını gösterir
catch_all	Etki alanının, alıcı adresinden bağımsız olarak gelen tüm e-postaları kabul eden bir tümünü yakala e-posta yapılandırmasına sahip olup olmadığını belirtir
email_address	E-posta adresi
remaining_credits	Hesabınızda kalan API kredisi sayısı

Örnek Yanıt

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "test@example.com",
  "remaining_credits": 99
}

Kod Örnekleri

curl "https://api.verify-email.app/v1/verify/deliverable?input=test@example.com" \
  -H "X-API-Key: your-api-key"

Dene bakalım

API Anahtarı

Uç noktaları test etmek için bir API anahtarına ihtiyacınız vardır.

E-posta Adresi veya Alan Adı

Birlikte deneyin:

Beyaz liste ve kara liste

Kullanıcı başına kara ve beyaz liste kurallarıyla hangi e-postaların ve alan adlarının engelleneceğini kontrol edin. Bu listeler her doğrulama yanıtındaki block alanını doğrudan belirler.

{}

block alanı

Her doğrulama yanıtında bir block alanı vardır. E-posta/alan adını listelerinize göre engellemek gerekip gerekmediğini bu alana bakarak belirleyin:

trueE-posta veya alan adı kara listede → block: true. Bir alan adı eklemek, o alan adındaki tüm e-postaları engeller.

trueBeyaz liste açık ama e-posta/alan adı listede yok → block: true.

falseBeyaz liste açık ve e-posta veya alan adı listede → block: false.

—Hiçbir liste uygulanmıyor → block normal doğrulama sonucunu izler.

Genel bakış

✘

Kara liste

Belirli e-postaları veya tüm alan adlarını her zaman engelleyin. Örneğin example.com'u kara listeye eklemek, @example.com e-postalarının doğrulama sonucundan bağımsız olarak block: true döndürmesi anlamına gelir.

✔

Beyaz liste

Yalnızca belirli e-postaları veya alan adlarını izin verin. Beyaz liste açıkken yalnızca listedekiler block: false alır; diğer her şey block: true. Örneğin gmail.com eklemek @gmail.com'lara izin verir, user@yahoo.com engellenir. Kapalıyken beyaz listenin etkisi olmaz.

Tam bir e-posta (user@example.com) veya alan adı (example.com) ekleyebilirsiniz. Alan adı eklemek, o alan adındaki tüm e-postalara uygulanır. Büyük/küçük harf farkı yoktur.

Nasıl çalışır

Değerlendirme sırası

Önce kara liste — E-posta adresi veya alan adı kara listedeyse sonuç block: true'dur. Başka liste mantığı uygulanmaz.

Beyaz liste (açıksa) — E-posta/alan adı beyaz listede → block: false. Değilse → block: true.

Beyaz liste kapalı — Yalnızca kara liste ve normal doğrulama uygulanır.

Kara liste her zaman önceliklidir: kara listedeki bir adres beyaz listede olsa bile engelli kalır.

Ne eşleştirilir

E-posta doğrulama — API hem tam e-posta adresini hem alan adını her iki listeyle kontrol eder. Eşleşme liste kuralını uygular.

Alan adı doğrulama — yalnızca alan adı kara listeyle ve (açıksa) beyaz listeyle kontrol edilir.

Hızlı referans

Beyaz liste açık	Kara listede	Beyaz listede	block değeri
Hayır	Evet	—	`true`
Hayır	Hayır	—	Normal
Evet	Evet	Herhangi	`true`
Evet	Hayır	Evet	`false`
Evet	Hayır	Hayır	`true`

Liste API uç noktaları

Tüm liste uç noktaları şu başlığı gerektirir: X-API-Key: your-api-key

Kara liste

GET/v1/blacklist

Kara liste girdilerini listele

POST/v1/blacklist

E-posta veya alan adı ekle · { "value": "..." }

DELETE/v1/blacklist

Girdi kaldır · value=...

Beyaz liste

GET/v1/whitelist

Beyaz liste girdilerini listele

POST/v1/whitelist

E-posta veya alan adı ekle · { "value": "..." }

DELETE/v1/whitelist

Girdi kaldır · value=...

GET/v1/whitelist/enabled

Beyaz liste durumunu al · { "enabled": boolean }

PUT/v1/whitelist/enabled

Beyaz listeyi aç/kapat · { "enabled": true | false }

Değer biçimi

user@example.com — E-posta: geçerli biçim, örn. user@example.com
example.com — Alan adı: geçerli biçim, örn. example.com

Geçersiz değerler 400 ile reddedilir. Girdiler normalleştirilmiş saklanır. Yinelenenler tek girdide birleştirilir.

Listelerin uygulandığı yerler

Liste kuralları doğrulamadan sonra uygulanır. Tek ve toplu e-posta ile alan adı doğrulama yanıtlarında block alanında kullanıcının kara ve beyaz listesi zaten yer alır.

MCP Sunucusu (AI Agent Entegrasyonu)

Model Bağlam Protokolünü (MCP) kullanarak e-posta doğrulamasını doğrudan Cursor ve Claude Desktop gibi yapay zeka aracılarına entegre edin. Yapay zeka asistanınız, editörden ayrılmadan e-postaları doğrulayabilir, etki alanlarını kontrol edebilir ve sözdizimini doğrulayabilir.

Kurulum

Aşağıdaki yapılandırmayı .cursor/mcp.json veya Claude Desktop yapılandırma dosyanıza ekleyin:

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Mevcut Araçlar

Alet	Açıklama	Giriş	Krediler
verify_email	Söz dizimi, MX, SMTP, tek kullanımlık, gizlilik ve teslim edilebilirlik kontrolleri dahil olmak üzere tam e-posta doğrulaması	{ email: string }	1
verify_domain	MX kayıtları, tek kullanımlık, gizlilik ve catch-all tespiti dahil olmak üzere tam alan adı doğrulaması	{ domain: string }	1
check_deliverability	Harici API çağrıları olmadan MX ve SMTP doğrulaması kullanarak yalnızca hızlı teslim edilebilirlik kontrolü	{ email: string }	1
verify_batch	Tek bir talepte 100 adede kadar e-posta veya alan adı için toplu doğrulama	{ inputs: string[] }	1 per item
validate_email_syntax	RFC 5322'ye karşı ağ çağrısı olmadan hızlı yerel sözdizimi doğrulaması	{ email: string }	0 (free)