· 3 min read
WhatsApp Toplu Numara Kontrolü Derin API (Deep API)
Küresel telefon numaralarını WhatsApp hesapları için kontrol edin ve cinsiyet, yaş, saç rengi ve profil resmi analizi dahil olmak üzere ayrıntılı demografik bilgileri alın.
Küresel telefon numaralarının WhatsApp’taki cinsiyet, yaş ve profil resmi analizi dahil olmak üzere demografik bilgilerini ve profil özelliklerini kontrol edin.
API URL
POST https://api.checknumber.ai/v1/tasks
Ana Özellikler
WhatsApp Toplu Numara Kontrolü Derin API’si (Deep API) güçlü analitik yetenekler sunar:
Demografik Analiz
API, profil resimlerinden elde edilen aşağıdakiler dahil olmak üzere ayrıntılı demografik bilgiler sağlar:
- Cinsiyet tespiti
- Yaş tahmini
- Saç rengi analizi
- Ten rengi/etnik köken tespiti
Profil Özellikleri
Aşağıdakiler dahil kapsamlı profil bilgileri:
- WhatsApp hesap durumunun doğrulanması
- Profil resmi URL’sinin alınması
- Profil resmi türünün sınıflandırılması
- Hesap doğrulama durumu
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.
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_avatar"'
İ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_avatar — avatar tabanlı öznitelikler |
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"
}
WhatsApp Numara Kontrolü Sonuç Alanları
| Alan | Açıklama | Örnek |
|---|---|---|
Number | E.164 formatında telefon numarası | +905321234567 |
age | Profil resmine göre tahmini yaş aralığı | 25 |
avatar | WhatsApp profil resminin URL’si | https://checknumber.ai/avatar.jpg |
category | Profil resmi türünün sınıflandırılması | individual portrait, pet avatar, object vb. |
gender | Profil resminden tespit edilen cinsiyet | male, female |
hair_color | Profil resminden tespit edilen saç rengi | black, brown, blonde vb. |
whatsapp | Numaranın aktif WhatsApp 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. Demografik analiz ne kadar doğru?
Demografik analiz, profil resimlerinin gelişmiş yapay zeka (AI) işlemelerine dayanır ve mevcut olduğunda yaş, cinsiyet ve diğer nitelikler için tahminler sağlar.
4. API yanıt durum kodları nelerdir?
API, başarı veya başarısızlığı belirtmek için standart HTTP durum kodlarını kullanır:
200: Başarılı istek (ücretlendirilir)400: Geçersiz parametreler veya dosya formatı (ücretsiz)500: Dahili sunucu hatası (ücretsiz)
5. Derin API’nin (Deep API) fiyatlandırması nedir?
Fiyat 10.000 numara başına 6 ABD Doları’dır. Bu API yanıt bilgisi şunları içerir:
- WhatsApp hesap durumunun doğrulanması
- Cinsiyet tespiti
- Yaş tahmini
- Profil resmi türü analizi
- Etnik köken tespiti
- Saç rengi analizi
Daha yüksek hacimli işlemler ve fiyatlandırma hakkında daha fazla bilgi için lütfen bizimle iletişime geçin.