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, [email protected] 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": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Kod Örnekleri

curl "https://api.verify-email.app/v1/[email protected]" \
  -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": [
      "[email protected]",
      "[email protected]"
    ]
  }'

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. [email protected]). 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": "[email protected]",
  "remaining_credits": 99
}

Kod Örnekleri

curl "https://api.verify-email.app/v1/verify/[email protected]" \
  -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, [email protected] engellenir. Kapalıyken beyaz listenin etkisi olmaz.

Tam bir e-posta ([email protected]) 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 }

Kod Örnekleri (cURL)

✘

Kara liste

GET/v1/blacklist

Kara liste girdilerini listele

curl "https://api.verify-email.app/v1/blacklist" \
  -H "X-API-Key: your-api-key"

POST/v1/blacklist

E-posta veya alan adı ekle

curl -X POST "https://api.verify-email.app/v1/blacklist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/blacklist

Girdi kaldır

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

✔

Beyaz liste

GET/v1/whitelist

Beyaz liste girdilerini listele

curl "https://api.verify-email.app/v1/whitelist" \
  -H "X-API-Key: your-api-key"

POST/v1/whitelist

E-posta veya alan adı ekle

curl -X POST "https://api.verify-email.app/v1/whitelist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/whitelist

Girdi kaldır

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

GET/v1/whitelist/enabled

Beyaz liste durumunu al

curl "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "X-API-Key: your-api-key"

PUT/v1/whitelist/enabled

Beyaz listeyi aç/kapat

curl -X PUT "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "enabled": true
  }'

Değer biçimi

[email protected] — E-posta: geçerli biçim, örn. [email protected]
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.

Docs endpoint for AI agents

The API exposes a machine-readable docs endpoint (no API key required) so AI agents and MCP clients can discover the server, available tools, and auth requirements. Use this URL in your agent or MCP configuration.

GET /v1/mcp/docs

Returns JSON with server name, description, serverUrl, docsEndpoint, authentication details, and full tool definitions.

curl "https://api.verify-email.app/v1/mcp/docs"

AI agents can GET this URL to receive server metadata, tool schemas, and integration instructions in JSON. No authentication is required for the docs endpoint.

Open docs endpoint How to add in Cursor How to add in Claude

Integration details

Authentication

All MCP tool calls require your API key in the X-API-Key header. Get your key from the dashboard.

MCP server URL: https://api.verify-email.app/mcp

Docs endpoint (for agents): https://api.verify-email.app/v1/mcp/docs

Cursor

Add the server in Cursor Settings → Tools & MCP, or add the config to .cursor/mcp.json in your project or home directory.

Claude Desktop

Add the server to your Claude Desktop config (mcpServers in claude_desktop_config.json). Use the server URL and X-API-Key header as shown below.

Response format

Tool results match the REST API response shape (valid, block, deliverable, remaining_credits, etc.). Use the block field for blacklist/whitelist decisions.

This MCP server is production-ready and uses the same API as the REST endpoints. Credits are consumed per verification as with the REST API.

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)