Skip to content
Mühendislik
8 dk okuma29 Eylül 2025

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.

Telefon doğrulama sisteminin bileşenlerini gösteren teknik mimari diyagramı

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 entegrasyon akış diyagramı

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ı

  1. Oturum Başlatma: İstemci, POST /start-verification ile doğrulama oturumu ister
  2. Bu işlem, bir oturum kimliğine bağlı benzersiz bir doğrulama belirteci üretir; ikisi de bir redis veritabanında saklanır.
  3. 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
  4. 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
  5. 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
Reverse-OTP entegrasyon akış diyagramı

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

< 200ms
API Yanıt Süresi
99.9%
Çalışma Süresi SLA'sı
500 rps'e kadar
ve ölçeklenebilir

Ö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ı

POST
/start-verification

Yeni bir doğrulama oturumu başlatın

GET
/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

100%
QR Üretildi
~90%
QR Tarandı
~89%
WhatsApp Açıldı
~85%
Mesaj Gönderildi

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ı.

🚀 Ücretsiz katman: ayda 100 doğrulama
📚 Eksiksiz API dokümantasyonu
🛠️ JS, Python, PHP, Go için SDK'lar