Teknik İnceleme: Modern Bir Telefon Doğrulama Sistemi Kurmak
Telefon doğrulama platformumuzun ardındaki mimariye, teknolojilere ve mühendislik kararlarına kapsamlı bir bakış. Arka uç altyapısını, API tasarımını, güvenlik değerlendirmelerini ve gerçek zamanlı doğrulama akışını keşfedin.

Sisteme Genel Bakış
Telefon doğrulama sistemimiz; arka uç hizmetleri için Supabase'in, telekomünikasyon altyapısı için Vonage'ın ve gerçek zamanlı yeteneklere sahip React tabanlı bir ön yüzün gücünü birleştiren, modern ve ölçeklenebilir bir mimari üzerine kuruludur. Sistem, saniye altı yanıt süreleri ve %99,9 çalışma süresiyle binlerce doğrulama isteğini karşılayabilir.
Ön Yüz Yığını
- React 18 - Eşzamanlı özelliklere sahip bileşen tabanlı arayüz
- TypeScript - Tür güvenli geliştirme
- Vite - Hızlı geliştirme ve optimize edilmiş derlemeler
- Tailwind CSS - Özel tasarım sistemiyle yardımcı sınıf öncelikli stillendirme
- Framer Motion - Akıcı animasyonlar ve geçişler
- React Query - Sunucu durumu yönetimi ve önbellekleme
Arka Uç Yığını
- Supabase - Gerçek zamanlı aboneliklere sahip PostgreSQL veritabanı
- Supabase Edge Functions - API uç noktaları için sunucusuz Deno çalışma zamanı
- Supabase Row Level Security - Veritabanı düzeyinde erişim denetimi
- Vonage API - Telekomünikasyon altyapısı
- Vonage Cloud Runtime - Barındırılan, ölçeklenebilir, yüksek performanslı arka uç hizmetleri
- Stripe - Ödeme işleme ve abonelik yönetimi

Reverse OTP Mimarisi
Sistemimizin temel yeniliği, kullanıcıların doğrulama kodlarını elle girme ihtiyacını ortadan kaldıran “Reverse OTP” akışıdır. Kullanıcılar bunun yerine telefonlarıyla bir QR kodu tarar ve doğrulamayı tamamlamak için bir WhatsApp mesajı gönderir.
Doğrulama Akışı Adımları
- Oturum Başlatma: İstemci, POST /start-verification ile doğrulama oturumu ister Bu işlem, bir oturum kimliğine bağlı benzersiz bir doğrulama belirteci üretir; ikisi de bir redis veritabanında saklanır.
- WhatsApp Entegrasyonu: Belirteci içeren, önceden doldurulmuş bir mesaj barındıran doğrudan bir WhatsApp deep link'i üretilir. Bu bağlantı, botumuza önceden doldurulmuş bir mesajla WhatsApp'a yönlendiren bir QR kodu olarak sunulabilir
- Telefon Çıkarımı: Vonage'ın barındırdığı arka uç, WhatsApp'tan bir webhook alır ve telefon numarasını WhatsApp mesajından çıkarır
- Doğrulama: Sistem telefon numarası biçimini doğrular ve doğrulama belirteci sayesinde onu özgün oturumla ilişkilendirir. Ön yüz doğrulama durumunu sürekli kontrol edebilir

Veritabanı Şeması Tasarımı
Supabase, gerçek zamanlı yeteneklere sahip sağlam bir PostgreSQL veritabanı sunar ve bu da onu doğrulama sistemimiz için ideal bir seçim yapar. Portalın omurgası olarak ve kullanıcı bilgileri, API anahtarları ile kotaları için bir veri deposu olarak hizmet eder. Ayrıca günlük kaydı ve analiz amaçlarıyla da kullanılır. PostgreSQL şemamız ölçeklenebilirlik, güvenlik ve performans için tasarlanmıştır. Kullanıcıların yalnızca kendi verilerine erişebilmesini sağlamak için Row Level Security politikaları kullanırız; sistem işlemlerini ise servis rolleri yürütür.
Güvenlik Özellikleri
- Row Level Security: Kullanıcılar yalnızca kendi doğrulama oturumlarına erişebilir
- API Anahtarı Doğrulaması: Tüm istekler API anahtarına göre doğrulanır
- Oturum Sona Ermesi: Süresi dolan doğrulama oturumları otomatik olarak temizlenir
- Hız Sınırlama: Kötüye kullanıma ve spam'e karşı yerleşik koruma
- Denetim Günlüğü: Tüm doğrulama girişimlerinin kapsamlı kaydı
Güvenlik Mimarisi
Telefon doğrulama sisteminde güvenlik her şeyden önemlidir. Dolandırıcılığı, kötüye kullanımı ve yetkisiz erişimi önlemek için birden çok koruma katmanı uygularız. Kısa ömürlü doğrulama belirteçleri ile taranan tam telefon numarasının listeleme yeteneği olmayan, kısa süreli depolamasını kullanırız. Hiçbir açık telefon numarası tutmaz; analiz ve hata ayıklama amaçlarıyla kısaltılmış bir sürümünü kullanırız.
Performans ve Ölçeklenebilirlik
Sistemimiz, yüksek hacimli doğrulama isteklerini asgari gecikmeyle karşılamak üzere tasarlanmıştır. Bunu özenli mimari tercihler ve optimizasyon stratejileriyle başarıyoruz.
Performans Metrikleri
Ölçeklenme Değerlendirmeleri
Doğrulama hacmi büyüdükçe mimarimiz şu yollarla yatay olarak ölçeklenir:
- • Otomatik Edge Function ölçekleme
- • Webhook kuyruğu işleme
- • Bölgeler arası yük dengeleme
- • Vonage örneklerinin otomatik ölçeklenmesi
Entegrasyon ve API Tasarımı
REST API'miz sadelik ve güvenilirlik için tasarlanmıştır. Geliştiriciler telefon doğrulamasını yalnızca birkaç API çağrısıyla uygulamalarına entegre edebilir.
API Uç Noktaları
/start-verificationYeni bir doğrulama oturumu başlatın
/check-verification-status/{session_id}Doğrulama durumunu gerçek zamanlı kontrol edin
Oturum ve Belirteç Yönetimi
Doğrulama sistemimiz; güvenliği sağlamak, ilerlemeyi izlemek ve kötüye kullanımı önlemek için gelişmiş bir oturum ve belirteç yönetim sistemi kullanır. Her doğrulama isteği, kullanıcı yolculuğu boyunca birden çok izleme noktası olan benzersiz bir oturum oluşturur.
Oturum Yaşam Döngüsü
1. Oturum Oluşturma
Bir doğrulama isteği başlatıldığında sistem şunları üretir:
- • Oturum Kimliği: Doğrulama girişimini izlemek için benzersiz UUID
- • Doğrulama Belirteci: QR koda gömülü, kriptografik olarak güvenli belirteç
- • Sona Erme Süresi: Tamamlamak için 15 dakikalık pencere
2. Belirteç Doğrulama
Doğrulama belirteci birden çok amaca hizmet eder: WhatsApp mesajının kimliğini doğrulamak, tekrar saldırılarını önlemek ve telefon numarasını doğru oturumla ilişkilendirmek. Belirteçler tek kullanımlıktır ve otomatik olarak sona erer.
Doğrulama Durum Aşamaları
Doğrulama sistemi, kullanıcı yolculuğu boyunca ayrıntılı durum bilgisini izler; gerçek zamanlı geri bildirim sağlar ve kullanıcı davranışı ile dönüşüm oranları üzerinde kesin analizlere olanak tanır.
Durum İlerlemesi
pending
Doğrulama oturumu oluşturulduğundaki başlangıç durumu. QR kod üretildi ancak henüz taranmadı.
qr_code_scanned
Kullanıcı QR kodu cihazıyla taradı. İzleme URL'sine erişildi.
whatsapp_previewed
WhatsApp açıldı ve mesaj önizlendi, ancak henüz gönderilmedi.
opened
WhatsApp konuşması tamamen açıldı, mesaj gönderilmeye hazır.
verified / sms_validated
Telefon numarası başarıyla çıkarıldı ve doğrulandı. Doğrulama tamamlandı.
expired / failed
Oturumun süresi doldu (15 dk zaman aşımı) veya geçersiz belirteç/telefon numarası nedeniyle başarısız oldu.
WhatsApp Önizleme ve QR Kod İzleme
Gelişmiş izleme mekanizmaları, doğrulama sürecinin her adımında kullanıcı etkileşimini izler; kullanıcı davranışına dair ayrıntılı analizler sunar ve dönüşüm oranlarını optimize etmeye yardımcı olur.
QR Kod Tarama Tespiti
İzleme URL'si Üretimi
Her QR kod, WhatsApp'a yönlendirmeden önce tarama olayını kaydeden benzersiz bir izleme URL'si içerir:
https://t.phone-verif.com/t/{validation_token}?sid={session_id}WhatsApp Durum İzleme
Önizleme Tespiti
WhatsApp, bağlantı önizlemeleri oluştururken izleme URL'mizi çağırır; bu da mesajın yazıldığı ancak henüz gönderilmediği anı tespit etmemizi sağlar.
- • User-Agent Analizi: WhatsApp önizleme botlarını gerçek kullanıcılardan ayırt edin
- • Zamanlama Analizi: Önizleme ile gerçek erişimi birbirinden ayırın
- • IP Coğrafi Konumu: Coğrafi tutarlılığı doğrulayın
Dönüşüm Hunisi Analitiği
QR kod üretiminden başarılı doğrulamaya kadar tipik dönüşüm oranları
Gelecek Yol Haritası
Platformu yeni özellikler ve optimizasyonlarla sürekli iyileştiriyoruz.
Başlayın
Telefon doğrulamasını uygulamanıza entegre etmeye hazır mısınız? API'miz, kapsamlı dokümantasyon ve popüler programlama dilleri için SDK'larla geliştiriciler için tasarlandı.

