Viber Yaş ve Cinsiyet Denetleyici API: Toplu Profil Tespiti

Telefon numaralarının Viber hesabı olup olmadığını kontrol edin ve her birini profil öznitelikleriyle (yaş, cinsiyet, avatar, son çevrimiçi) zenginleştirin. Diğer denetleyicilerle aynı toplu görev iş akışı.

Algılama dosyası yükleyin — örnek:

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

Görev durumunu kontrol edin — örnek:

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

Yükleme başarılı yanıtı

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2026-04-28T11:58:08.916446594Z"
}

İşleniyor durumu yanıtı

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Tamamlandı yanıtı (exported)

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

Dosya yükleme istek URL’i

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

Dosya yükleme istek parametreleri

Parametre	Açıklama
file	file, her satırda bir telefon numarası (E.164 formatında)
task_type	string, viber_senior olarak ayarlayın

Görev durumunu kontrol edin istek URL’i

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

Görev durumunu kontrol edin istek parametreleri

Parametre	Açıklama
task_id	string, Görev oluşturma sırasında dönen görev kimliği

Sonuç alanları

Alan	Açıklama
number	E.164 formatında telefon numarası
activated	Hesabın kayıtlı/etkin olup olmadığı (yes / no)
last_online_time	Hesabın en son çevrimiçi görüldüğü zaman
active_days	Son aktif gün aralığı
mid	Dahili Viber üye kimliği
nickname	Profil görünen adı
person_count	Avatarda algılanan yüz sayısı
avatar_type	Avatar sınıflandırması
age	Tahmini yaş aralığı
skin_color	Tahmini ten rengi
gender	Tahmini cinsiyet
avatar	Avatar görsel URL’si (varsa)

Yanıt formatı

Alan	Açıklama
created_at	Görevin oluşturulduğu zaman damgası
updated_at	Son görev durumu güncellemesinin zaman damgası
task_id	Benzersiz görev tanımlayıcısı
user_id	Kullanıcı Kimliği
status	pending · processing · exported · failed (otomatik iade edilir)
total	İşlenen toplam telefon numarası
success	Başarıyla tanımlanan numaralar
failure	İşlenemeyen numaralar
result_url	status exported olduğunda indirme URL’i
actual_amount	(İsteğe bağlı) Fiilen tahsil edilen tutar; görev kapatıldıktan sonra döner
estimated_amount	(Oluşturma yanıtı) Görevin tahmini tutarı; nihai ücret görev tamamlanınca kesinleşir

Durum kodları

Durum	Açıklama
200	free, istek başarılı (ör. durum sorgusu)
202	charge, görev başarıyla oluşturuldu; tahmini tutar düşülür
400	free, hatalı istek: geçersiz parametreler veya dosya biçimi, desteklenmeyen görev türü ya da geçerli kayıt sayısının minimum partinin altında olması
401	free, eksik veya geçersiz API anahtarı
402	free, yetersiz bakiye
404	free, görev bulunamadı
413	free, yüklenen dosya çok büyük
500	free, sunucu iç hatası, daha sonra tekrar deneyin