E.164 Numaralarla TG Kayıt Kontrolü Nasıl Yapılır

E.164 formatındaki telefon numaralarıyla senkron Telegram kayıt kontrollerini entegre etmeye yönelik; API iş akışlarını, toplu işlemeyi ve kullanım kontrollerini kapsayan teknik bir rehber.

Bir Telegram kayıt kontrolü yapmak için E.164 formatındaki bir telefon numarasını TG Validator platformuna gönderin. Hizmet, tanımlayıcının kayıt durumunu gösteren senkron bir yanıt sağlar.

Telegram Kayıt Kontrollerini Anlamak

TG Validator, çok platformlu bir denetleyici değil, Telegram doğrulamasına odaklanmış tek bir üründür. Kuruluşlar kişi listelerini işlerken veya kullanıcı kayıtlarını değerlendirirken doğru yönlendirme bilgisine ihtiyaç duyar. Bir Telegram kayıt sinyali dahili kararlara bilgi sağlar ve kişi segmentasyonu iş akışlarını destekler. Ürün senkron olduğundan tek numaralık bir istek, aynı HTTP yanıtında tek bir sonuç döndürür. Bu aynı yanıt iş akışı, teknik ekiplerin karmaşık yoklama (polling) mekanizmaları kurmadan kontrolü doğrudan yönlendirme mantıklarına entegre etmesine yardımcı olur. Bu sinyalin kapsamını tam olarak tanımlamak önemlidir. Kayıtlı sonucu, Telegram platformunda hesap varlığını doğrular. Ekipler bu erişilebilirlik sinyalini, operasyonel iş akışlarını desteklemek için diğer kontrollerin yanında girdilerden biri olarak kullanabilir.

Verilerinizi Hazırlamak: E.164 Biçimlendirmesi

API'ye bir istek göndermeden önce teknik ekipler verilerinin doğru biçimlendirildiğinden emin olmalıdır. TG Validator platformu, gönderilen tüm telefon numaralarının E.164 formatını kullanmasını şart koşar. E.164, genel anahtarlamalı telefon şebekesindeki her cihaza benzersiz ve standartlaştırılmış bir numara atanmasını sağlayan uluslararası bir telefon numaralandırma planıdır. Bu format genellikle bir artı işaretini, ardından ülke kodunu ve abone numarasını içerir. Numaraları bu standart formatta göndermek API için kesin bir gerekliliktir. Bir istek hatalı biçimlendirilmiş bir tanımlayıcı içerirse sistem, geçersiz telefon numarası için bir hata kodu döndürür. Kuruluşlar, bir kontrol başlatmadan önce yerel veya özel telefon numarası formatlarını katı E.164 dizelerine dönüştürmek için veri hazırlama hatlarına normalleştirme adımları eklemelidir. Bu hazırlık, tutarlı API performansını destekler ve reddedilen isteklerin hacmini azaltır.

Kayıt Kontrollerini Çalıştırmak

TG Validator platformu, kontrolleri çalıştırmak için senkron bir REST API sunar. Belgelenmiş istek sözleşmesi POST /api/v1/check uç noktasını kullanır. Kimlik doğrulama için istekler, hesabın kimlik bilgisini içeren X-API-Key başlığını ve bir Content-Type: application/json başlığını içermelidir. JSON gövdesi iki belirli alan gerektirir: tg olarak ayarlanmış service_type ve E.164 formatındaki telefon numarasını içeren identifier. Hizmet, tek numaralı kontrolleri senkron olarak destekler ve istek başına bir tanımlayıcı işler. Daha büyük hacimler işleyen kuruluşlar için senkron bir toplu uç nokta, tek bir istekte en fazla 100 tanımlayıcı kabul eder. Bu toplu uç nokta, grubun tamamının sonucunu aynı HTTP yanıtında döndürür ya da bütün olarak başarısız olur; böylece görev gönderimi, yoklama, geri çağırma veya dosya indirme gerektirmeden aynı yanıt iş akışını korur. Başarılı işlemden sonra dış yanıt zarfı code, msg ve data alanlarını içerir. Herkese açık data nesnesi service_type, identifier ve bir registered boolean alanını içerir. Telegram hizmet türü için API yalnızca bu registered alanını döndürür; avatar veya business alanları döndürmez. registered boolean değeri yalnızca tamamlanmış ve karara bağlanmış bir kontrol için sağlanır. Bir kontrol karara bağlanamazsa API sıfır olmayan bir iş kodu döndürür ve tamamlanmış bir sonuç nesnesi döndürmez.

API Operasyonlarını ve Güvenilirliği Yönetmek

TG Validator API'sini entegre ederken teknik ekipler kullanım kontrollerini ve hata işlemeyi hesaba katmalıdır. Sistem, dakika başına istek hızı sınırı yerine kullanıcı başına eşzamanlılık ve zaman aşımı kontrolleri kullanır. Ekipler, bu belirli davranışlar için güvenli istemci tarafı işleme tasarlamak üzere güncel API dokümantasyonuna başvurmalıdır. Bir sistem kullanılabilir eşzamanlılık yuvalarını aşan istekler gönderirse API bir eşzamanlılık sınırı reddi döndürür. Bu retler bir kontrol oluşturulmadan önce gerçekleşir; yani tamamlanmış bir kontrol sonucu üretmezler. Herkese açık API dokümantasyonu, geliştiricilerin işlemesi gereken belirli hata kodlarını listeler: desteklenmeyen hizmet türü, geçersiz JSON gövdesi, geçersiz telefon numarası, eksik veya geçersiz API anahtarı, yetersiz bakiye, tüm eşzamanlılık yuvalarının dolu olması, kontrol zaman aşımı ve doğrulama hizmeti bakımı. Hizmetin faturalandırması kontrol başına esasa göre işler. Bir kontrol başarısız olursa veya belirlenemezse (sıfır olmayan bir iş koduyla sonuçlanırsa) sistem o istek için otomatik iade işler. Eşzamanlılık retleri ücretlendirilmez.

Geliştirici Paneli Üzerinden İş Akışlarını İzlemek

API operasyonlarını desteklemek için TG Validator bir SaaS web paneli sunar. Bu arayüz, ekiplerin entegrasyonlarını yönetmesine ve kullanım örüntülerini zaman içinde izlemesine yardımcı olur. Panel API anahtarı yönetimini destekleyerek yöneticilerin X-API-Key başlığı için gereken kimlik bilgilerini oluşturmasına ve yenilemesine yardımcı olur. Operatörler paneli hesap bakiyesini, kontrol geçmişini ve kullanım raporlarını incelemek için de kullanabilir. Arayüz son kontrolleri, bakiye harcama ayrıntılarını ve yedi günlük eğilimleri gösterir. Bu görünürlük, kuruluşların doğrulama hacimlerini takip etmesine, belirli hata kodlarının sıklığını izlemesine ve hesaplarının eşzamanlılık gereksinimlerini karşılayacak yeterli bakiyeyi korumasını sağlamasına yardımcı olur.

MCP Uyumlu Yapay Zekâ İstemcileriyle Entegrasyon

Standart REST API'ye ek olarak TG Validator resmi bir Model Context Protocol (MCP) Sunucusu sunar. Bu sunucuya web sitesinin /mcp yolu üzerinden Streamable HTTP ve JSON-RPC ile erişilebilir. Claude Code, Cursor veya Claude Desktop gibi MCP uyumlu yapay zekâ istemcilerinin kontrol hizmetiyle etkileşime geçmesini destekler. MCP entegrasyonu müşterinin mevcut API anahtarını kullanır ve ayrı bir hesap ya da kimlik bilgisi gerektirmez. REST API ile tamamen aynı ürünleri, bakiyeyi, kimlik doğrulamayı, eşzamanlılık sınırlarını, zaman aşımlarını, faturalandırmayı ve sonuç anlamlarını paylaşır. Bir yapay zekâ asistanına sunulan araçlar arasında mevcut ürünleri listeleme, tek bir E.164 numarasını kontrol etme, en fazla 100 E.164 numarasından oluşan küçük bir grubu senkron olarak kontrol etme ve hesap bakiyesini sorgulama yer alır. Bu MCP çağrıları gerçek zamanlı ve senkron kalır; asenkron görevler oluşturmadan aynı yanıt iş akışını kullanır.

SSS

Bir Telegram kayıt sonucu neyi gösterir?

Gönderilen E.164 telefon numarasının bir Telegram hesabıyla ilişkili olup olmadığını doğrular. Bu sinyal, ekiplerin kayıtları yönlendirmesine ve kişileri segmentlere ayırmasına yardımcı olur.

Birden fazla telefon numarasını aynı anda kontrol edebilir miyim?

Evet, platform senkron bir toplu uç nokta aracılığıyla toplu işlemeyi destekler. Bu uç nokta, tek bir istekte en fazla 100 E.164 tanımlayıcı kabul eder. Sistem isteği işler ve grubun tamamının sonucunu aynı HTTP yanıtında döndürür ya da bütün olarak başarısız olur.

Başarısız kontroller hesabımdan ücretlendirilir mi?

Hayır, faturalandırma kesinlikle kontrol başınadır ve sistem başarısız veya belirlenemeyen tüm kontrolleri otomatik olarak iade eder.