iMessage Toplu Numara Kontrolcüsü API: Hızlı Numara Doğrulama

Girilen global numaranın iMessage ayrıntılarını kontrol edin, bir iMessage hesabı olup olmadığını

Tespit Dosyası Yükleme Kod örneği:

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

Görev Durumunu Kontrol Etme Kod örneği:

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

Tespit dosyası yüklemesi 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"
}

İşleme 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
}

Görevin tamamlandığını belirten bir yanıt sağlayın ve sonuçlar için indirme URL’sini ekleyin.

{
    "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://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256...",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

Dosya yükleme istek URL’si

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

Dosya yükleme istek parametreleri

Parametre	Açıklama
file	file, Dosya yükle, her satır E.164 formatında bir telefon numarası içermelidir
task_type	string, Görev türü, “imessage” olarak ayarlayın

Görev durumu kontrol istek URL’si

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

Görev durumu kontrol istek parametreleri

Parametre	Açıklama
task_id	string, Görev oluşturulmasından döndürülen Görev ID’si

Sonuç Alanları

Alan	Açıklama	Örnek
Number	E.164 formatında telefon numarası	+12025551234
imessage	Numaranın aktif iMessage hesabı olup olmadığı	yes, no

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ı ID’si
status	Görev durumu: pending: Sırada ve bekliyor processing: Şu anda işleniyor exported: Sonuçlar indirilebilir failed: Görev başarısız oldu, tahsil edilen tutar otomatik olarak iade edilir
total	İşlenen toplam telefon numarası
success	Başarıyla tanımlanan numaralar
failure	İşleme başarısız olan numaralar
result_url	(İsteğe bağlı) Durum exported olduğunda sonuçlar için indirme URL’si
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