Telegram için Gerçek Zamanlı Telefon Doğrulama API İş Akışı Planlama

TG Validator ile gerçek zamanlı bir telefon doğrulama API iş akışı tasarlamaya yönelik teknik bir rehber: senkron tekli ve çoklu uç noktalar, eşzamanlılık sınırları, E.164 formatı ve sinyal yorumlama.

TG Validator doğrulama iş akışı gerçek zamanlı kontroller üzerine kuruludur: tek bir E.164 tanımlayıcıyı POST /api/v1/check uç noktasına veya en fazla 100 tanımlayıcıyı senkron çoklu uç nokta POST /api/v1/batch-check'e gönderirsiniz ve tamamlanan kayıt sonuçları isteği başlatan HTTP yanıtında döner. İstemci tarafı eşzamanlılığı API dokümantasyonuna göre kontrol edin. Tek bir gerçek zamanlı isteğin çok ötesindeki bir listenin tamamı için ek seçenek olarak asenkron toplu görev de mevcuttur.

Senkron Doğrulama Modelini Anlamak

TG Validator'ın birincil modeli senkrondur. Tek bir tanımlayıcı için POST /api/v1/check uç noktasını veya en fazla 100 tanımlayıcı için senkron çoklu uç nokta POST /api/v1/batch-check'i kullanın; tamamlanan sonuçlar aynı HTTP yanıtında döner, görev gönderme, sorgulama, geri çağırma veya indirme adımı yoktur ve aynı ülke şartı bulunmaz. Büyük bir listenin tamamı için yedek seçenek olarak asenkron toplu görev (/api/v1/bulk-tasks) de mevcuttur: dosyayı yükleyin, bir görev kimliği alın, ardından görevi sorgulayın ve bittiğinde sonuç dosyasını indirin. Görev gönderirken numaraların ait olduğu ülkeyi seçersiniz ve liste esas olarak o tek ülkeye ait olmalıdır. Bu rehberin geri kalanı senkron yola odaklanmaktadır.

Verilerinizi Doğrulamaya Hazırlama

İstek göndermeye başlamadan önce veri kümenizdeki tüm telefon numaralarının E.164 uluslararası numaralandırma planına göre biçimlendirildiğinden emin olun. API, bir X-API-Key başlığı ve bir Content-Type: application/json başlığı gerektirir. service_type=tg ve tek bir E.164 identifier ile POST /api/v1/check uç noktasını veya service_type=tg ve en fazla 100 E.164 numarası içeren bir identifiers dizisiyle senkron çoklu uç nokta POST /api/v1/batch-check'i kullanın. TG Validator yalnızca Telegram'a odaklandığından hizmet türü her zaman tg olmalıdır.

Gerçek Zamanlı Telefon Doğrulama API İş Akışı Mimarisi Kurma

Gerçek zamanlı bir telefon doğrulama API iş akışında en kritik bileşen işlem hacmini yönetmektir. TG Validator API, bir hesabın aynı anda işlemde tutabileceği kontrol sayısını sınırlar ve güncel üst sınır API dokümantasyonunda belirtilir. İstemci tarafı uygulamanız bu sınır içinde kalmak için istekleri kısıtlamalıdır. Sisteminiz bu eşiği aşarsa API istekleri reddeder. Eşzamanlılık sınırı retleri ücretlendirilmez ve bir kontrol sonucu oluşturmaz; bu nedenle uygulamanız bu tür istekleri güvenli şekilde duraklatıp yeniden deneyecek biçimde tasarlanmalıdır.

Kayıt Sinyalini Yorumlama

API, belgelenmiş bir kod, mesaj ve veri yanıt zarfı döndürür. Bu zarf içinde Telegram kayıt durumu data.registered alanında yer alır. Bu sonuç yalnızca kontrol anındaki bir hesap varlığı sinyali işlevi görür. Ürün avatar veya business alanları döndürmez; yük tamamen kayıt durumuna odaklanır.

İzleme ve Hata Yönetimi

Yeniden denenebilir hataları ele almak için API yanıt kodunu kullanın; güncel hata kodları ve sınırlar için API dokümantasyonuna bakın.

SSS

Eşzamanlılık sınırına ulaşırsam ne yapmalıyım?

API, API dokümantasyonunda belirtildiği üzere her hesaba yalnızca sınırlı sayıda eşzamanlı kontrol izni verir. Bu sınırı aşarsanız API, bakiyenizden ücret düşmeden ve sonuç üretmeden isteği reddeder. Uygulamanız eşzamanlılık hata kodunu yakalamalı, kısa bir süre beklemeli ve isteği yeniden denemelidir.

'registered' durumu bir kullanıcıya ulaşılabildiğini doğrular mı?

Hayır. Kayıt sinyali yalnızca kontrolün yapıldığı andaki Telegram hesap varlığını gösterir.

İş akışı tek bir isteği aşan bir listeyi nasıl ele almalı?

Birincil yol olarak senkron çoklu uç noktayı, belgelenmiş eşzamanlılık sınırı içinde ve istek başına en fazla 100 tanımlayıcıyla kullanmaya devam edin. Bunun çok ötesindeki bir listenin tamamı için asenkron bir toplu görev de mevcuttur (yükleyin, bekleyin, indirin); gönderirken numaraların ait olduğu ülkeyi seçersiniz, liste esas olarak o tek ülkeye ait olmalıdır ve ürün bazında en az ve en fazla adetler API dokümantasyonunda listelenir.

Başarısız kontroller faturalandırma açısından nasıl ele alınır?

Başarısız, zaman aşımına uğrayan ve belirlenemeyen kontroller için ücret alıkonmaz. Güncel plan ve bakiye ayrıntıları için fiyatlandırma sayfasına bakın.