Toplu E-posta Kontrolcüsü API: Gmail, Outlook, Yahoo ve Daha Fazlası

Yüklediğiniz listede hangi e-posta adreslerinin Gmail, Outlook, Yahoo, Mail.ru veya iCloud’da kayıtlı olduğunu doğrulayın. task_type email_check ve diğer kontrolcüler ile aynı toplu sorgulama akışını kullanır.

Algılama dosyası yükleyin — örnek:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./emails.txt"' \
--form 'task_type="email_check"'

Görev durumunu kontrol edin — örnek:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Yükleme başarılı yanıtı

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2000,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

İşleniyor durumu yanıtı

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2000,
    "success": 800,
    "failure": 0
}

Tamamlandı yanıtı (exported)

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2000,
    "success": 2000,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

Dosya yükleme istek URL’i

POST https://api.checknumber.ai/v1/tasks

Dosya yükleme istek parametreleri

Parametre	Açıklama
file	file, her satırda bir e-posta adresi
task_type	string, email_check olarak ayarlayın

Görev durumunu kontrol etme istek URL’i

POST https://api.checknumber.ai/v1/gettasks

Görev durumunu kontrol etme istek parametreleri

Parametre	Açıklama
task_id	string, Görev oluşturma sırasında dönen görev kimliği

Sonuç alanları

Sonuç ZIP’i, e-posta sağlayıcısı başına ayrı dosyalar içerir. Her satır aşağıdakileri içerir:

Alan	Açıklama
Email	E-posta adresi
Active	E-postanın platform üzerinde kayıtlı olup olmadığı (true / false)
Provider	Algılanan e-posta sağlayıcısı: gmail, outlook, yahoo, mailru, icloud, veya unsupported

Desteklenen sağlayıcılar

Sağlayıcı	task_type alt-görev
Gmail	email_gmail
Outlook	email_outlook
Yahoo	email_yahoo
Mail.ru	email_mailru
iCloud	email_icloud

Minimum toplu boyut: 2.000 e-posta adresi görev başına.

Yanıt formatı

Alan	Açıklama
created_at	Görevin oluşturulduğu zaman damgası
updated_at	Görev durumunun son güncellenmesinin zaman damgası
task_id	Benzersiz görev tanımlayıcısı
user_id	Kullanıcı kimliği
status	pending · processing · exported · failed (otomatik iade edilir)
total	Gönderilen toplam e-posta sayısı
success	Başarıyla kontrol edilen e-postalar
failure	İşlenemeyen satırlar
result_url	status değeri exported olduğunda indirme URL’i
actual_amount	(İsteğe bağlı) Fiilen tahsil edilen tutar; görev kapatıldıktan sonra döner
estimated_amount	(Oluşturma yanıtı) Görevin tahmini tutarı; nihai ücret görev tamamlanınca kesinleşir

Durum kodları

Durum	Açıklama
200	free, istek başarılı (ör. durum sorgusu)
202	charge, görev başarıyla oluşturuldu; tahmini tutar düşülür
400	free, hatalı istek: geçersiz parametreler veya dosya biçimi, desteklenmeyen görev türü ya da geçerli kayıt sayısının minimum partinin altında olması
401	free, eksik veya geçersiz API anahtarı
402	free, yetersiz bakiye
404	free, görev bulunamadı
413	free, yüklenen dosya çok büyük
500	free, sunucu iç hatası, daha sonra tekrar deneyin