· 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

ParametreTürAçıklama
filefileKontrol edilecek numaraları içeren, her satırda bir numara olan dosya
task_typestringws_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ı

AlanAçıklamaÖrnek
NumberE.164 formatında telefon numarası+905321234567
ageProfil resmine göre tahmini yaş aralığı25
avatarWhatsApp profil resminin URL’sihttps://checknumber.ai/avatar.jpg
categoryProfil resmi türünün sınıflandırılmasıindividual portrait, pet avatar, object vb.
genderProfil resminden tespit edilen cinsiyetmale, female
hair_colorProfil resminden tespit edilen saç rengiblack, brown, blonde vb.
whatsappNumaranın aktif WhatsApp 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. 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.

Related Posts

View All Posts »