· 2 min read

WhatsApp Toplu Numara Kontrolü Detay API'si (Details API)

Küresel bir telefon numarasının WhatsApp'ta olup olmadığını kontrol edin ve imzalar (status mesajları) ve durum güncellemeleri de dahil olmak üzere ayrıntılı profil bilgilerini alın.

Küresel bir telefon numarasının kayıtlı bir WhatsApp hesabı olup olmadığını kontrol edin ve ayrıntılı profil bilgilerini alın.

API URL

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

Ana Özellikler

WhatsApp Toplu Numara Kontrolü Detay API’si (Details API) kapsamlı doğrulama yetenekleri sunar:

Hesap Bilgileri

Aşağıdakiler de dahil olmak üzere ayrıntılı WhatsApp hesap bilgileri:

  • Hesap durumu doğrulaması
  • Kullanıcı imzaları (durum mesajları)
  • Durum güncelleme zaman damgaları

Toplu İşlem (Bulk Processing)

Birden fazla numarayı dosya yüklemesi yoluyla aynı anda işleyin, bu da büyük ölçekli doğrulamalar için etkili bir yöntemdir.

Gerçek Zamanlı Durum Güncellemeleri

Toplu doğrulama görevlerinizin ilerlemesini gerçek zamanlı durum güncellemeleri ile izleyin.

Kullanım Adımları

Dosya Yükleme

E.164 formatında telefon numaralarını içeren bir metin (.txt) dosyası yükleyin:

İstek Örneği

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

İstek Parametreleri

ParametreTürAçıklama
filefileKontrol edilecek numaraları içeren, her satırda bir numara olan dosya
task_typestringws_active — aktivite / imza

Durum Kontrolü

Görevinizin işlenme durumunu izleyin:

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

Yanıt Örnekleri

Görev Oluşturma Yanıtı

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

İşleme Durumu Yanıtı

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

Tamamlanmış Görev Yanıtı

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

Sonuç Alanları

AlanAçıklamaÖrnek
NumberE.164 formatında telefon numarası+905321234567
signatureWhatsApp durumu veya imzası”Hey there! I am using WhatsApp”
status_updateSon durum güncelleme zamanı2025-01-19
whatsappNumaranın aktif bir hesabı olup olmadığıyes, no

API Yanıt Formatı

AlanAçıklama
created_atGörevin oluşturulma zaman damgası
updated_atSon görev durumu güncellemesi zaman damgası
task_idBenzersiz görev tanımlayıcı
statusGörev durumu: pending/processing/completed/exported
totalİşlenen toplam telefon numarası
successBaşarıyla tanımlanan numara sayısı
failureBaşarısız işlem denemeleri
result_url(Opsiyonel) Durum ‘exported’ olduğunda sonuçlar için indirme URL’si

Durum Kodları (Status Codes)

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

Entegrasyon Notları

  1. Girdi dosyasındaki her satır, E.164 formatında bir telefon numarası içermelidir.
  2. Sağlanan task_id’yi kullanarak görev durumunu izleyin.
  3. Durum “exported” (dışa aktarıldı) olduğunda sonuçları result_url’den indirin.
  4. Uygulamanızda farklı durum kodlarını uygun şekilde ele alın.

SSS (Sıkça Sorulan Sorular)

1. API’nin işlem kapasitesi nedir?

API, büyük numaraların toplu işlemlerini verimli bir şekilde yapabilir ve işlem ilerlemesi hakkında gerçek zamanlı güncellemeler sağlar.

2. Girdi dosyası hangi formatta olmalıdır?

Girdi dosyası, E.164 formatında (örn. +905321234567) her satırda bir telefon numarası içeren bir metin dosyası olmalıdır.

3. API hangi bilgileri döndürür?

API, aşağıdakileri içeren ayrıntılı hesap bilgilerini döndürür:

  • WhatsApp hesap durumu
  • Kullanıcı imzası (durum mesajı)
  • Son durum güncelleme zaman damgası
4. API’nin fiyatlandırması nedir?

Fiyat, durum güncellemeleri ve imzalar (status mesajları) dahil olmak üzere ayrıntılı WhatsApp hesap bilgileri için 10.000 numara başına 2 $‘dır.

Daha yüksek hacimli işlemler ve fiyatlandırma hakkında daha fazla bilgi için lütfen bizimle iletişime geçin.

Related Posts

View All Posts »