Telegram Username Activity API: Toplu kontrol

Telegram kullanıcı adlarını toplu kontrol edin; kullanıcı kimliği, son görülme, aktif gün aralığı ve üyelik durumunu alın.

Girdi biçimi

Her satırda bir kullanıcı adı bulunan bir metin dosyası yükleyin. Yüklemeden önce değerleri normalleştirin.

@example_user
@another_user

Görev oluşturma

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

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

API bir görev kimliği döndürür. Bu kimliği saklayın ve görev durumunu sorgulamak için kullanın.

Yükleme yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Görev durumunu kontrol etme

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

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

status değeri exported olana kadar sorgulayın. pending ve processing tamamlanmış sonuç değildir.

İşleme yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Dışa aktarılan yanıt

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Sonuç alanları

Alan	Açıklama	Örnek
username	Yüklenen dosyadaki kullanıcı adı.	example_user
activated	Kullanıcı adının Telegram’da kayıtlı olup olmadığı (yes / no).	yes
uid	Telegram sayısal kullanıcı kimliği.	7084480174
lastseen	Hesabın son çevrimiçi olduğu tarih (YYYY-MM-DD).	2026-08-01
activedays	Sağlayıcının bildirdiği aktif gün aralığı, örn. over 30 days.	over 30 days
member	Hesabın Telegram üyeliği (Premium) olup olmadığı (yes / no).	no
avatar_url	Herkese açık avatar bağlantısı, CDN’imizde barındırılır. Hesabın herkese açık fotoğrafı yoksa boştur.	https://telegram.waavatar.xyz/v/a.jpg

Not: Üç Telegram kullanıcı adı ürünü tek bir hattın aşamalarıdır. Herkese açık avatarı olmayan bir hesap kayıt aşamasından sonra durur; etkinlik ve profil kolonları boş teslim edilir.

Sonuç dosyası işlemleri

Dosyayı result_url üzerinden yalnızca görev dışa aktarıldıktan sonra indirin. Dosyayı işlerken döndürülen sütun adlarını koruyun.

Yanıt alanları

Alan	Açıklama
created_at	Görevin oluşturulduğu zaman.
updated_at	Son görev durumu güncellemesinin zamanı.
task_id	Benzersiz görev tanımlayıcısı.
status	pending, processing, exported veya failed.
total	İşlenen toplam giriş değeri.
success	Başarıyla işlenen değerler.
failure	İşlenemeyen değerler.
result_url	Görev dışa aktarıldığında indirme URL’si.
actual_amount	Varsa kesinleşen tutar.
estimated_amount	Görev oluşturulurken döndürülen tahmini tutar.

Durum kodları

Status	Açıklama
200	İstek başarılı.
202	Görev başarıyla oluşturuldu ve tahmini ücret uygulandı.
400	Geçersiz dosya, desteklenmeyen görev türü veya çok az geçerli giriş.
401	API anahtarı eksik veya geçersiz.
402	Yetersiz hesap bakiyesi.
404	Görev bulunamadı.
413	Yüklenen dosya çok büyük.
500	Dahili sunucu hatası; daha sonra tekrar deneyin.

Operasyon notları

• Görev eşzamansızdır; durumu sorgulamak için görev kimliğini kullanın.
• Yüklemeden önce ürüne özel giriş sınırlarını kontrol edin.
• Başarısız satırlar dışa aktarılan sonuçta raporlanır ve görev sayaçlarına yansıtılır.
• Yukarıdaki alanlar mevcut canlı sample temelindedir ve dışa aktarma şeması değişirse değişebilir.