Telegram Toplu Avatar, Yaş ve Cinsiyet Kontrolcüsü API'si: Profil Analizi

Yüklenen global telefon numaraları için Telegram hesaplarının avatar bilgilerini kontrol edin; hesabın etkin olup olmadığını, profil fotoğrafı URL’sini, cinsiyeti, yaşı, saç rengini ve cilt rengini öğrenin.

Dosya yükleme örneği:

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

Görev durumunu kontrol etme örneği:

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

Dosya 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": "2025-11-21T15:58:08.916446594Z"
}

İşleniyor durumu yanıtı

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

Tamamlandı yanıtı (indirme URL’i dahil)

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256...",
    "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, Dosya yükleyin, her satır E.164 formatında bir numara içermelidir
task_type	string, Görev tipi, “tg_avatar” olarak ayarlayın

Görev durumunu kontrol etme istek URL’i

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

Görev durumunu kontrol etme 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	Örnek
Number	E.164 formatında telefon numarası	+41798284651
telegram	Numaranın etkin Telegram hesabı olup olmadığı	yes, no
avatar	Telegram profil resmi URL’si	https://example.com/avatar.jpg
age	Profil resmine dayalı tahmini yaş aralığı	25
gender	Profil resminden tespit edilen cinsiyet	male, female
category	Profil resmi türü sınıflandırması	individual portrait, pet avatar, object, etc.
hair_color	Profil resminden tespit edilen saç rengi	black, brown, blonde, etc.
skin_color	Profil resminden tespit edilen cilt rengi	white, black, etc.

Yanıt formatı

Alan	Açıklama
created_at	Görev oluşturulduğunda 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	Görev durumu: pending: Sırada bekleniyor processing: İşleniyor exported: Sonuçlar indirmeye hazır failed: Görev başarısız oldu, tahsil edilen tutar otomatik olarak iade edilir
total	İşlenen toplam telefon numarası sayısı
success	Başarıyla tanımlanan numaralar
failure	İşlenemez numaralar
result_url	(İsteğe bağlı) Status “exported” olduğunda sonuçlar için 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