· 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
| Parametre | Tür | Açıklama |
|---|---|---|
file | file | Kontrol edilecek numaraları içeren, her satırda bir numara olan dosya |
task_type | string | ws_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ı
| Alan | Açıklama | Örnek |
|---|---|---|
Number | E.164 formatında telefon numarası | +905321234567 |
signature | WhatsApp durumu veya imzası | ”Hey there! I am using WhatsApp” |
status_update | Son durum güncelleme zamanı | 2025-01-19 |
whatsapp | Numaranın aktif bir hesabı olup olmadığı | yes, no |
API Yanıt Formatı
| Alan | Açıklama |
|---|---|
created_at | Görevin oluşturulma zaman damgası |
updated_at | Son görev durumu güncellemesi zaman damgası |
task_id | Benzersiz görev tanımlayıcı |
status | Görev durumu: pending/processing/completed/exported |
total | İşlenen toplam telefon numarası |
success | Başarıyla tanımlanan numara sayısı |
failure | Başarısız işlem denemeleri |
result_url | (Opsiyonel) Durum ‘exported’ olduğunda sonuçlar için indirme URL’si |
Durum Kodları (Status Codes)
| 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, Dahili sunucu hatası, daha sonra tekrar deneyin |
Entegrasyon Notları
- Girdi dosyasındaki her satır, E.164 formatında bir telefon numarası içermelidir.
- Sağlanan
task_id’yi kullanarak görev durumunu izleyin. - Durum “exported” (dışa aktarıldı) olduğunda sonuçları
result_url’den indirin. - 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.