Telegram telefon numarası kaydı gerçek zamanlı olarak nasıl kontrol edilir

Ürün tek ve kesin bir soruyu yanıtlar

TG Validator, gönderilen telefon numarasının istek anında Telegram'da kayıtlı olup olmadığını kontrol eder.

Ürün tek bir E.164 telefon numarası kabul eder, service_type=tg kullanır ve tamamlanmış sonucu aynı HTTP yanıtında döndürür. Uygulamanın data.registered değerini okuyabilmesi için yoklanacak bir iş kimliği veya gerekli bir geri çağırma yoktur.

Kapsam kayıt durumuyla sona erer. Yanıt bir Telegram kullanıcı adı, profil, etkinlik durumu, kişiler, gruplar veya mesaj verisi sağlamaz. Telefon numarasını kontrol eden kişiyi de tanımlamaz. Bunlar gizli özellikler değildir; ürün sözleşmesinin dışındadır.

Tamamlanmış bir false, başarısız bir kontrolden farklıdır

Bu ayrım önemlidir, çünkü registered=false tamamlanmış bir kontrolün ürettiği kullanılabilir bir bilgidir. Bir API hatası, kendi HTTP durumu ve sayısal code değeriyle dış zarf üzerinden döndürülür; data.registered alanının başka bir değeri değildir.

Senkron istek yolu

1. E.164 girdisini hazırlayın — Bilinen ülke bağlamıyla başlayın ve numarayı artı işareti, ülke arama kodu ve rakamlar biçiminde normalleştirin.
2. İsteğin kimliğini doğrulayın — Ayarlar'da oluşturulan bir API anahtarını kullanın ve belgelenmiş başlıkla gönderin.
3. Telegram ürününü seçin — service_type=tg olarak ayarlayın; ürünü ilgisiz alanlardan çıkarsamayın.
4. Aynı yanıtı bekleyin — Kontrol senkron olduğundan uygulama kararı yoklama yapmadan alır.
5. Tam sonuç alanlarını okuyun — code=0 olduğunda data.registered değerini kullanın; API sıfır olmayan bir iş kodu döndürdüğünde bu alanı boş bırakın.
6. Kontrol zamanını kaydedin — Sonucu süresiz bir garanti olarak değil, güncel bir gözlem olarak ele alın.

Gerçek zamanlı davranışın işe yaradığı yerler

Senkron sözleşme, devam etmeden önce tek bir güncel kayıt kararına ihtiyaç duyan yazılımlar için uygundur. Bir operatör paneldeki bir kaydı kontrol edebilir, dahili bir uygulama gönderilen bir numarayı doğrulayabilir veya bir arka uç işçisi kayıtları tek tek işleyebilir.

Küçük bir liste için senkron toplu uç nokta en fazla 100 E.164 tanımlayıcı kabul eder ve tamamlanmış grubu isteği başlatan yanıtta döndürür. Zamanlama ve eşzamanlılık istemcinin sorumluluğundadır. Bu, basit bir API sözleşmesini korur: tamamlanmış her sonucun bir girdisi, bir Telegram kayıt sonucu ve bir gözlem zamanı vardır.

Asgari bir uygulama kaydı

Belirsiz bir valid etiketi yerine açık alanlar kullanın:

Bir uygulamanın daha yeni bir yanıta ihtiyacı varsa başka bir senkron çağrı yapmalıdır. Eski bir değerin zaman damgasını değiştirmemeli veya önbelleğe alınmış bir değerin gerçek zamanlı olduğunu iddia etmemelidir.

Yanlış veriyi önleyen entegrasyon kuralı

code=0, registered boolean değerinin tamamlanmış kayıt yanıtı olduğunu doğrular.

Bu iki aşamalı yorumlama, girdi sorunlarını ve geçici hizmet koşullarını Telegram durum alanının dışında tutar. Ayrıca ürün vaadini kesinleştirir: TG Validator, kontrol tamamlandığında güncel bir kayıt gözlemini senkron olarak sağlar; entegre eden sistem ise ne zaman yeni bir gözleme ihtiyaç duyduğuna karar verir.