Twitter/X Email Checker API: Toplu E-posta Doğrulaması

Dosyanızdaki e-postaların Twitter/X ile kayıtlı olup olmadığını kontrol edin. task_type twitter_email kullanır ve diğer e-posta tabanlı hizmetlerle aynı toplu yoklama akışı vardı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="twitter_email"'

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": 2049,
    "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": 2049,
    "success": 1024,
    "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": 2049,
    "success": 2049,
    "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`, `twitter_email` olarak ayarlayın

Görev durumunu kontrol edin istek URL’i

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

Görev durumunu kontrol edin istek parametreleri

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

Sonuç alanları

Alan	Açıklama
`Email`	E-posta adresi
`twitter`	E-postanın Twitter/X üzerinde kayıtlı olup olmadığı

Yanıt formatı

Alan	Açıklama
`created_at`	Görevin oluşturulduğu zaman damgası
`updated_at`	Son görev durumu güncellemesinin 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`	İşlenen toplam e-postalar
`success`	Başarıyla doğrulanan e-postalar
`failure`	İşlenemeyen satırlar
`result_url`	`status` `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