WhatsApp Toplu Numara Kontrolü Basit API (Simple API)

WhatsApp küresel olarak baskın bir mesajlaşma platformudur ve hesap durumunu geniş ölçekte doğrulamak, işletmeler için değerli içgörüler sağlayabilir. Bu makale, birden fazla numara için WhatsApp hesap durumunun eşzamanlı ve verimli bir şekilde doğrulanmasını sağlayan WhatsApp Toplu Numara Kontrolü Basit API’sini (Simple API) tanıtmaktadır.

Ana Özellikler

WhatsApp Toplu Numara Kontrolü Basit API’si temel doğrulama yetenekleri sunar:

Hesap Doğrulama

Küresel olarak herhangi bir telefon numarası için WhatsApp hesap durumunun hızlı ve güvenilir doğrulaması.

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:

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

Görev Detaylarını Alın

Durumu sorgulamak için POST https://api.checknumber.ai/v1/gettasks ve task_id form alanını kullanın (aşağıdaki curl). Eski /wa/api/simple/... yolları kullanılmaz.

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

İstek Parametreleri

• file: Kontrol edilecek numaraları içeren dosya.
• task_type: WhatsApp kayıt kontrolü için ws kullanın. Resmi dokümantasyon.

Yanıt Parametreleri

• task_id: Görevin ID’si.
• created_at: Görevin oluşturulduğu zaman.
• updated_at: Görevin son güncellendiği zaman.
• status: Görevin durumu.
• total: Görevdeki toplam numara sayısı.
• success: Başarıyla kontrol edilen numara sayısı.
• failure: Başarısız olan numara sayısı.
• result_url: Sonuç dosyasını indirmek için URL.

İstek Gövdesi

Yanıt Gövdesi

Sonuç Alanları (Result Fields)

API temel doğrulama bilgilerini döndürür:

• Telefon numarası (E.164 formatı)
• WhatsApp hesap durumu (yes/no)

API Yanıt Formatı

API, görev durumu hakkında ayrıntılı bilgi sağlar:

• created_at: Görevin oluşturulma zaman damgası
• updated_at: Son durum güncelleme zaman damgası
• task_id: Benzersiz görev tanımlayıcısı
• status: Mevcut görev durumu (pending/processing/completed/exported)
• total: İşlenen toplam numara
• success: Başarıyla işlenen numara sayısı
• failure: Başarısız işlem denemeleri
• result_url: Tamamlanan sonuçlar için indirme URL’si

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 temel doğrulama bilgisini döndürür: bir telefon numarasının aktif bir WhatsApp hesabına sahip olup olmadığı.

4. API yanıt durum kodları nelerdir?

• 200: Başarılı istek (ücretlendirilir)
• 400: Geçersiz parametreler veya dosya formatı (ücretsiz)
• 500: Dahili sunucu hatası (ücretsiz)

5. API’nin fiyatlandırması nedir?

Fiyat, temel WhatsApp hesap durumu doğrulaması için 10.000 numara başına 1 ABD Doları’dır.

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