E-posta Teslim Edilebilirlik Kontrolü API

Her yükleme için bir görev türü seçin: teslim edilebilirlik için email_check, avatarlar için email_avatar. Her ikisi de aşağıdaki asenkron toplu işlem akışını kullanır.

Teslim Edilebilirlik Kontrolü (email_check)

E-posta adreslerinin aktif olup olmadığını ve posta alıp alamadığını kontrol eder. Yalnızca Gmail, Yandex, Mail.ru, iCloud, Outlook ve Yahoo desteklenir.

Avatar Kontrolü (email_avatar)

E-posta adreslerinin herkese açık bir avatarı olup olmadığını kontrol eder ve avatar URL’sini döndürür. Yalnızca Gmail, Yandex ve Mail.ru desteklenir.

Listelenen sağlayıcılar ve desteklenen takma ad alanları dışındaki adresler işleme, sonuçlara ve ücretlendirmeye dahil edilmez.

Girdi biçimi

Her satırda desteklenen bir e-posta adresi bulunan bir metin dosyası yükleyin.

user@gmail.com
another@yandex.com

Görev oluşturma

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

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

Avatar Kontrolü (email_avatar)

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

API bir görev kimliği döndürür. Bu kimliği saklayın ve görev durumunu sorgulamak için kullanın.

Yükleme yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Görev durumunu kontrol etme

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

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

status değeri exported olana kadar sorgulayın. pending ve processing tamamlanmış sonuç değildir.

İşleme yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Dışa aktarılan yanıt

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Sonuç alanları

Teslim Edilebilirlik Kontrolü (email_check)

Alan	Açıklama	Örnek
email	Gönderilen dosyadaki giriş e-posta adresi.	user@gmail.com
activated	Girdinin etkin veya kayıtlı olarak algılanıp algılanmadığı.	yes

Avatar Kontrolü (email_avatar)

Alan	Açıklama	Örnek
email	Gönderilen dosyadaki giriş e-posta adresi.	user@gmail.com
activated	Adresin herkese açık avatarı olup olmadığı.	yes
avatar	Varsa avatar görsel bağlantısı; hesap varsayılan yer tutucu kullanıyorsa boş.	https://…
name	Sağlayıcı açıklıyorsa görünen ad; aksi halde boş.	John Doe

Sonuç dosyası işlemleri

Dosyayı result_url üzerinden yalnızca görev dışa aktarıldıktan sonra indirin. Dosyayı işlerken döndürülen sütun adlarını koruyun.

Yanıt alanları

Alan	Açıklama
created_at	Görevin oluşturulduğu zaman.
updated_at	Son görev durumu güncellemesinin zamanı.
task_id	Benzersiz görev tanımlayıcısı.
status	pending, processing, exported veya failed.
total	İşlenen toplam giriş değeri.
success	Başarıyla işlenen değerler.
failure	İşlenemeyen değerler.
result_url	Görev dışa aktarıldığında indirme URL’si.
actual_amount	Varsa kesinleşen tutar.
estimated_amount	Görev oluşturulurken döndürülen tahmini tutar.

Durum kodları

Status	Açıklama
200	İstek başarılı.
202	Görev başarıyla oluşturuldu ve tahmini ücret uygulandı.
400	Geçersiz dosya, desteklenmeyen görev türü veya çok az geçerli giriş.
401	API anahtarı eksik veya geçersiz.
402	Yetersiz hesap bakiyesi.
403	Ürün hesabınız için kullanılamıyor (kaldırıldı veya yalnızca beyaz listedeki müşterilere açık); destekle iletişime geçin.
404	Görev bulunamadı.
413	Yüklenen dosya çok büyük.
500	Dahili sunucu hatası; daha sonra tekrar deneyin.
503	Ürün geçici olarak kullanılamıyor (bakım için duraklatıldı); ücret alınmaz, daha sonra tekrar deneyin.

Operasyon notları

• Görev eşzamansızdır; durumu sorgulamak için görev kimliğini kullanın.
• Yüklemeden önce ürüne özel giriş sınırlarını kontrol edin.
• Başarısız satırlar dışa aktarılan sonuçta raporlanır ve görev sayaçlarına yansıtılır.
• Yukarıdaki alanlar mevcut canlı sample temelindedir ve dışa aktarma şeması değişirse değişebilir.