API Dokümantasyonu

E-posta Doğrulama API'si

Uygulamalarınız için basit, hızlı ve doğru e-posta doğrulama

Genel Bakış

Email Verifier, işletmelerin ve geliştiricilerin tek kullanımlık (geçici) e-posta adreslerini ve alan adlarını gerçek zamanlı olarak tanımlamasına ve önlemesine yardımcı olmak için tasarlanmış bir API'dir. Yalnızca meşru kullanıcıların kaydolabilmesini veya platformunuzla etkileşime geçebilmesini sağlayarak, Email Verifier işinizi dolandırıcılıktan korur, veri bütünlüğünü artırır ve operasyonel maliyetleri düşürür.

Email Verifier Neler Yapabilir?

E-postaları ve Alan Adlarını Doğrulama – Bir e-posta adresinin veya alan adının geçerli, aktif ve güvenilir olup olmadığını anında doğrulayın.
Tek Kullanımlık ve Spam Kaynaklarını Algılama – Geçici, tek kullanımlık veya bilinen spam e-posta adreslerini sisteminize girmeden önce engelleyin.
Alan Adı İtibarını Kontrol Etme – Genel e-posta sağlayıcılarını, aktarıcıları ve şüpheli alan adlarını tanımlayın.
Gerçek Zamanlı Doğrulama – Kullanıcı kaydı veya form gönderimi sırasında anında sonuçlar alın.

Neden Email Verifier Kullanmalı?

Platform Kötüye Kullanımını Önleme – Ücretsiz deneme sürümü istismarını durdurun, spam'i azaltın ve otantik kullanıcı topluluklarını koruyun.
Veri Kalitesini İyileştirme – Pazarlama, analiz ve destek çabalarınızın sahte hesaplara değil, gerçek kullanıcılara ulaşmasını sağlayın.
Maliyetleri Azaltma – Sahte kayıtları önleyerek, e-posta teslim edilebilirliğini artırarak ve dolandırıcılığı en aza indirerek kaynak tasarrufu yapın.
Kolay Entegrasyon – Basit REST API, net dokümantasyon ve doğrudan kurulum, entegrasyonu hızlı ve geliştirici dostu hale getirir.
Ölçeklenebilir ve Güvenilir – Yüksek performans, güvenilirlik ve küresel erişim için modern altyapı üzerine inşa edilmiştir.

Hızlı Başlangıç

Platformunuzu korumaya ve veri kalitenizi iyileştirmeye hazır mısınız? API anahtarınızı almak ve ilk API çağrınızı yapmak için şu adımları izleyin:

Adım 1: Hesap Oluştur

Email Verifier Konsolunu ziyaret edin.
Bilgilerinizi doldurun ve kayıt işlemini tamamlayın.

Hesabınızı oluşturduktan sonra otomatik olarak Email Verifier Konsol'una yönlendirileceksiniz.

Adım 2: API Anahtarlarınıza Erişin

Konsol'da sol menüye gidin ve Başlangıç → API Anahtarları'nı seçin.
Görüntülenen listeden API anahtarınızı kopyalayın veya gerekirse yeni bir tane oluşturun.

⚠️ Önemli: API anahtarınızı güvende tutun! Email Verifier hesabınıza erişim sağlar ve herkese açık olarak paylaşılmamalıdır.

Kimlik Doğrulama

Tüm API istekleri Bearer token kullanarak kimlik doğrulaması gerektirir. API anahtarınızı Authorization başlığına ekleyin:

Authorization: Bearer API_ANAHTARINIZ

Temel URL

https://api.getemailverifier.com

API Uç Noktaları

Email Verifier, e-postaları ve alan adlarını kontrol etmek için iki ana uç nokta sağlar.

E-posta Kontrol Et

Bir e-posta adresinin tek kullanımlık e-posta hizmetinden gelip gelmediğini kontrol eder. Tek kullanımlık durum, rol hesabı algılama, genel alan adı tanımlama ve takma ad algılama dahil olmak üzere kapsamlı analiz döndürür.

POST /v1/email/check

İstek Başlıkları

Başlık	Değer	Gerekli
Authorization	Bearer API_ANAHTARINIZ	Evet
Content-Type	application/json	Evet

İstek Gövdesi

Parametre	Tip	Gerekli	Açıklama
value	string	Evet	Kontrol edilecek e-posta adresi

Örnek İstek

curl --request POST \
  --url https://api.getemailverifier.com/v1/email/check \
  --header 'Authorization: Bearer API_ANAHTARINIZ' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": "[email protected]"
  }'

Yanıt Alanları

Alan	Tip	Açıklama
time	string	ISO 8601 formatında zaman damgası
success	boolean	İsteğin başarılı olup olmadığı
data.block	boolean	Önerilen eylem: e-posta engellenmeliyse true
data.disposable	boolean	Tek kullanımlık e-posta hizmetinden geliyorsa true
data.valid	boolean	E-posta formatı geçerliyse true
data.role_account	boolean	Rol hesabıysa (admin, support, vb.) true
data.public_domain	boolean	Genel sağlayıcıysa (Gmail, Yahoo, vb.) true
data.alias	boolean	Takma ad algılandıysa (Gmail noktaları, plus adresleme) true
data.details.input	string	Sağlanan orijinal girdi
data.details.normalized	string \| null	E-postanın normalleştirilmiş/kanonik formu
data.details.handle	string \| null	Normalleştirilmiş handle/yerel kısım (@ öncesi)
data.details.domain	string \| null	Alan adı kısmı (@ sonrası)
data.warning	string \| null	Ek bilgi veya uyarılar
processing_duration	integer \| null	İşlem süresi (milisaniye)
error	object \| null	İstek başarısız olduysa hata bilgileri

Örnek Yanıt

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": true,
  "data": {
    "block": false,
    "disposable": false,
    "valid": true,
    "role_account": false,
    "public_domain": true,
    "alias": false,
    "details": {
      "input": "[email protected]",
      "normalized": "[email protected]",
      "handle": "kullanici",
      "domain": "ornek.com"
    },
    "warning": null
  },
  "processing_duration": 7,
  "error": null
}

Alan Adı Kontrol Et

Bir alan adının tek kullanımlık e-posta hizmetinden gelip gelmediğini kontrol eder. Tek kullanımlık durum ve genel alan adı tanımlama döndürür.

POST /v1/domain/check

İstek Gövdesi

Parametre	Tip	Gerekli	Açıklama
value	string	Evet	Kontrol edilecek alan adı

Örnek İstek

curl --request POST \
  --url https://api.getemailverifier.com/v1/domain/check \
  --header 'Authorization: Bearer API_ANAHTARINIZ' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": "ornek.com"
  }'

Örnek Yanıt

Yanıt yapısı e-posta kontrol uç noktasıyla aynıdır. Alan adı kontrolleri için, details içindeki normalized ve handle alanları null olacaktır.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": true,
  "data": {
    "block": false,
    "disposable": false,
    "valid": true,
    "role_account": false,
    "public_domain": false,
    "alias": false,
    "details": {
      "input": "ornek.com",
      "normalized": null,
      "handle": null,
      "domain": "ornek.com"
    },
    "warning": null
  },
  "processing_duration": 5,
  "error": null
}

Hata Yanıtları

API, başarı veya başarısızlığı belirtmek için standart HTTP durum kodlarını kullanır. Tüm hata yanıtları, bir kod ve açıklama içeren bir hata nesnesi içerir.

400 Hatalı İstek

Geçersiz istek - değer sağlanmalı ve geçerli olmalıdır.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": false,
  "data": null,
  "processing_duration": null,
  "error": {
    "code": "BAD_REQUEST",
    "description": "Geçersiz istek - değer sağlanmalı ve geçerli olmalıdır"
  }
}

401 Yetkisiz

Eksik veya geçersiz API anahtarı kimlik doğrulaması.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": false,
  "data": null,
  "processing_duration": null,
  "error": {
    "code": "UNAUTHORIZED",
    "description": "Eksik veya geçersiz API anahtarı kimlik doğrulaması"
  }
}

429 Çok Fazla İstek

Hız sınırı aşıldı. Lütfen daha sonra tekrar deneyin.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": false,
  "data": null,
  "processing_duration": null,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "description": "Hız sınırı aşıldı. Lütfen daha sonra tekrar deneyin."
  }
}

500 İç Sunucu Hatası

İşlem sırasında iç sunucu hatası oluştu.

{
  "time": "2025-12-09T10:01:07.550234Z",
  "success": false,
  "data": null,
  "processing_duration": null,
  "error": {
    "code": "INTERNAL_ERROR",
    "description": "İç sunucu hatası oluştu"
  }
}

Kod Örnekleri

Email Verifier API'sini farklı programlama dillerinde nasıl kullanacağınıza dair örnekler.

JavaScript / Node.js

const response = await fetch('https://api.getemailverifier.com/v1/email/check', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer API_ANAHTARINIZ',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    value: '[email protected]'
  })
});

const data = await response.json();
console.log(data);

Python

import requests

url = "https://api.getemailverifier.com/v1/email/check"
headers = {
    "Authorization": "Bearer API_ANAHTARINIZ",
    "Content-Type": "application/json"
}
data = {
    "value": "[email protected]"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

PHP

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getemailverifier.com/v1/email/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer API_ANAHTARINIZ",
    "Content-Type: application/json"
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "value" => "[email protected]"
  ])
]);

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
print_r($data);

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    url := "https://api.getemailverifier.com/v1/email/check"

    payload := map[string]string{
        "value": "[email protected]",
    }
    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer API_ANAHTARINIZ")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

Destek

Yardıma mı ihtiyacınız var? Size yardımcı olmak için buradayız.

📧 Email: [email protected]