Telegram Numara Denetleyici — Hesapları Platform veya API aracılığıyla Toplu Doğrulayın

Bir Telegram numara denetleyicisi, telefon numaralarını E.164 biçiminde işler ve satır bazında bir Telegram sinyali döndürür. Yalnızca kayıt durumuna ihtiyacınız varsa temel tg görevini kullanın. Etkinlik ve herkese açık profil kontrolleri, farklı alanlara ve maliyetlere sahip ayrı ürünlerdir; temel sonucun bunları içerdiğini varsaymayın.

Bir partiyi kod yazmadan Telegram ürün arayüzünde çalıştırabilir veya düzenli listeleri aşağıda açıklanan REST API ile otomatikleştirebilirsiniz.

Önce Telegram sonuç derinliğini seçin

Kontrol	API görev türü	Temel çıktı	En uygun olduğu kullanım
Kayıt	`tg`	Gönderilen numara ve kayıt durumu	Kayıtsız satırları ayıklama ve temel liste segmentasyonu
Etkinlik	`tg_active`	Kayıt ile birlikte kullanılabilir kimlikler, son görülme zamanı, etkin günler ve üyelik durumu	Güncelliğe dayalı dahili segmentasyon
Herkese açık profil	`tg_avatar`	Kayıt ile birlikte kullanılabilir profil, avatar, etkinlik ve görselden türetilen nitelikler	Yetkili profil zenginleştirme incelemesi

İsteğe bağlı profil alanları boş olabilir. Herkese açık bir avatardan türetilen yaş ve cinsiyet nitelikleri doğrulanmış gerçekler değil, olasılıksal tahminlerdir ve bir kişi hakkında önemli sonuçlar doğuracak kararlar almak için kullanılmamalıdır. Güncel Telegram ürün sayfası, her düzey için yapılandırılmış çıktıları gösterir.

Girdi dosyasını hazırlayın

Her satırda uluslararası biçimde bir telefon numarası bulunan bir .txt veya .csv dosyası oluşturun. Dışa aktarılan her satırın güvenle eşleştirilebilmesi için kaynak sisteminizde kendi kalıcı kayıt kimliğinizi saklayın.

+14155550100
+41798284651
+447700900123

Göndermeden önce ülke kodlarını doğrulayın ve dahili numaraları kaldırın. Bir biçim hatası, onaylanmış bir “kayıtlı değil” sonucundan farklı ele alınmalıdır.

Telegram kayıt görevi gönderin

Resmi referans: Telegram Bulk CheckNumber API.

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

Parametre	Açıklama
`file`	Satır başına bir E.164 telefon numarası
`task_type`	Temel Telegram kayıt kontrolü için `tg`

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

Dönen task_id değerini saklayın. API anahtarını istemci tarafı kodda, tarayıcı günlüklerinde, analitik olaylarında veya paylaşılan ekran görüntülerinde açığa çıkarmayın.

Görevi sorgulayın ve sonuçları indirin

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

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

Sürekli istek göndermek yerine makul bir aralıkla sorgulayın. Görev exported durumuna ulaştığında dosyayı result_url adresinden alın.

Görev alanı	Anlamı
`created_at`, `updated_at`	Oluşturma ve en son durum zaman damgaları
`task_id`	Durum isteklerinde kullanılan tanımlayıcı
`status`	Örneğin `pending`, `processing` veya `exported`
`total`	Görevde gönderilen satır sayısı
`success`, `failure`	Tamamlanan ve başarısız satır sayıları
`result_url`	Dışa aktarma sonrası indirme konumu

Temel tg görevi için önemli sonuç sütunları, gönderilen Number ve telegram kayıt kararıdır. Eski bir dışa aktarmadaki alanları koda sabitlemek yerine güncel yanıt anahtarları için dokümantasyonu izleyin.

Listeyi bozmadan hataları yönetin

Yanıt	API’nin tanımladığı ücretlendirme	Uygulama davranışı
`200`	Ücretlendirilen başarılı istek	Görev kimliğini veya dönen durumu kaydedin
`400`	Ücretlendirilmez	Yeniden denemeden önce parametreleri veya dosya biçimini düzeltin
`500`	Ücretlendirilmez	Geri çekilme (backoff) ile daha sonra yeniden deneyin

Sonraki işlemlerde üç grup tutun: onaylanmış kayıtlı, onaylanmış kayıtlı değil ve çözümsüz/hatalı. Yalnızca çözümsüz satırları yeniden denemek, geçici bir hatanın olumsuz bir Telegram sonucu sanılmasını önler.

Telegram kaydının kanıtlamadıkları

Bir kayıt eşleşmesi; hesabın yakın zamanda aktif olduğunu, beklenen kişiye ait olduğunu, iletişime onay verdiğini veya yanıt vereceğini kanıtlamaz. Benzer şekilde, son görülme veya herkese açık profil sinyali erişilebilirlik ve gizlilik koşulları nedeniyle eksik olabilir.

İş akışınızın ihtiyaç duyduğu en düşük sonuç derinliğini kullanın, verilerin neden işlendiğini belgeleyin ve yerel gizlilik ile iletişim gerekliliklerini uygulayın. CheckNumber.AI’ın açıklanan kayıt sonucunu üretmek için gönderilen numaraya mesaj atması gerekmez.

Uygulama kontrol listesi

Numaraları E.164 biçimine normalleştirin ve bir kaynak kayıt kimliği saklayın.
tg, tg_active veya tg_avatar arasından seçimi en çok alanı sunana göre değil, gerekli alanlara göre yapın.
Platforma özgü tek bir görev gönderin ve task_id değerini kaydedin.
Görev nihai bir duruma ulaşana kadar geri çekilme ile sorgulayın.
Sonuçları hemen indirin ve onaylanmış sonuçları hatalardan ayırın.
Üretimde kullanmadan önce resmi API dokümantasyonunu ve güncel fiyatları inceleyin.

Sık sorulan sorular

Bir milyon numaralık bir görev ne kadar sürer?

İşlem süresi sunucu yüküne ve platform hız sınırlarına göre değişir. Entegrasyonu garantili bir tamamlanma süresine göre tasarlamayın; bunun yerine görev durumunu izleyin.

Kontrol bir Telegram mesajı gönderir mi?

Hayır. Kayıt kontrolü, gönderilen numaraya mesaj atmaz veya bildirim göndermez.

Tek bir görev Telegram’ı ve diğer platformları kontrol edebilir mi?

Hayır. Her görev platforma özgüdür. Bir iş akışı birden fazla platformdan sonuç gerektiriyorsa ayrı görevler gönderin.

Kullanılabilir kredi yetersizse ne olur?

Başarıyla işlenen satırlar kredi tüketir. Gönderilen her satırın tamamlandığını varsaymak yerine dönen görev ve satır durumlarını inceleyin.

Telegram Numara Denetleyici — Hesapları Platform veya API aracılığıyla Toplu Doğrulayın | CheckNumber.AI