WhatsApp Toplu Numara Kontrolcüsü API: Hızlı Telefon Numarası Doğrulama

Girilen global numaranın WhatsApp detaylarını kontrol edin, WhatsApp hesabı olup olmadığını öğrenin. Kısa süreli önbellek ve gerçek zamanlı algılamaya dayalı hizmet.

Algılama 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="ws"'

Görev Durumu Kontrolü Kod örneği:

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

Algılama dosyası başarıyla yüklendi yanıtı

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

İşlem durumu yanıtı

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Görevin tamamlandığını belirten ve sonuçlar için indirme URL’sini içeren yanıt

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Dosya yükleme istek URL’si

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

Dosya yükleme istek parametreleri

Parametre	Açıklama
file	file, Yükleme dosyası, her satır E.164 formatında bir telefon numarası içermelidir
task_type	string, Görev türü, “ws” 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şturmadan dönen Görev ID’si

Sonuç Alanları

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

Yanıt Formatı

Alan	Açıklama
created_at	Görev oluşturulma zamanı
updated_at	Görev durumunun son güncellenme zamanı
task_id	Benzersiz görev tanımlayıcısı
user_id	Kullanıcı ID’si
status	Görev durumu: pending: Kuyrukta ve beklemede processing: Şu anda işleniyor exported: Sonuçlar indirmeye hazır
total	İşlenen toplam telefon numarası sayısı
success	Başarıyla tanımlanan numaralar
failure	İşleme başarısız olan numaralar
result_url	(Opsiyonel) Durum exported olduğunda sonuçlar için indirme URL’si

Durum Kodları

Durum	Açıklama
200	charge, İstek başarılı, görev oluşturuldu veya durum alındı
400	free, Hatalı istek, geçersiz parametreler veya dosya formatı
500	free, Sunucu iç hatası, daha sonra tekrar deneyin