Telefon Doğrulama API'si
Kullanıcıların verdikleri telefon numarasının sahibi olduğunu doğrulayın.
Numara sahipliğini saniyeler içinde doğrulayın
Telefon doğrulaması, güvenilir her kullanıcı deneyiminin temelidir. SMS, WhatsApp veya sesli arama ile tek kullanımlık şifre (OTP) gönderin ve sahipliği saniyeler içinde doğrulayın.
Telefon doğrulaması nedir?
Telefon doğrulaması, karşınızdaki kişinin yazdığı telefon numarasını gerçekten kontrol ettiğini kanıtlama işlemidir. Bir formdaki numara bir iddiadır; doğrulama onu kanıta dönüştürür. Doğrulama olmadan bir kayıt alanı yazım hatalarını, tek kullanımlık numaraları, başkalarının numaralarını ve bir betiğin yapıştırmaya karar verdiği her şeyi kabul eder.
Bu kanıtın elde edilmeye değer olmasının üç ayrı nedeni var. Çalışan bir iletişim kanalı sağlar; böylece şifre sıfırlamaları ve teslimat bildirimleri gerçek bir cihaza ulaşır. Bir hesap için kararlı bir tanımlayıcı sağlar; çoklu hesap kullanımını ve bonus istismarını pahalı kılan da budur. Ve sonradan kullanıcıdan yeni bir şey kaydetmesini istemeden başvurabileceğiniz ikinci bir faktör sağlar.
Telefon doğrulaması nasıl çalışır?
Her telefon doğrulama akışı aynı fikre dayanır: cihazda yalnızca sahibinin gerçekleştirebileceği bir şey olmalıdır. Klasik sürüm SMS ile tek kullanımlık bir kod gönderir ve kullanıcıdan onu geri yazmasını ister. Phone-Verif bunu tersine çevirir: kullanıcı mesaj almak yerine mesaj gönderir. Ancak yapı aynıdır: bir oturum oluşturun, bir sınama sunun, kanıtı bekleyin, sonucu okuyun.
Pratikte bu, sizin tarafınızda üç hareketli parça demektir. Bir doğrulama oturumu açan ve kullanıcıya gösterecek bir şey veren bir çağrı. Kullanıcının buna göre hareket ettiği bir ekran veya widget. Ve sonucu öğrenmenin bir yolu: ya bir callback'ten ya da oturumun durumunu okuyarak.
WhatsApp doğrulaması
Burada birincil kanal WhatsApp'tır. API, kısa bir oturum belirteci içeren bir WhatsApp deep link'i döndürür; siz bunu masaüstünde QR kod, mobilde düğme olarak gösterirsiniz. Kullanıcı dokunur, WhatsApp mesaj önceden yazılmış hâlde açılır ve kullanıcı onu gönderir. WhatsApp gönderen numarayı sunucuya bildirir ve hesap oluşturulurken WhatsApp o numarayı doğruladığı için, kurmak zorunda olmadığınız bir kanıtı devralırsınız.
Bunun trafiğinizin ne kadarını kapsadığı tamamen pazara bağlıdır. WhatsApp kullanımı Brezilya'da, Hindistan'da ve Avrupa ile Afrika'nın büyük bölümünde neredeyse evrenseldir; Amerika Birleşik Devletleri'nde, Japonya'da ve Güney Kore'de ise marjinaldir. Ne kadar yedeğe ihtiyacınız olduğuna karar vermeden önce kullanıcılarınızın gerçekte nerede olduğunu kontrol etmeye değer.
SMS doğrulaması ve yedek
WhatsApp'ı olmayan kullanıcılar için aynı oturum aynı belirteci SMS ile de kabul eder: kullanıcı belirteci bunun yerine doğrulama numarasına düz metin mesajı olarak gönderir. Oturum, belirteç ve sonradan okuduğunuz durum aynıdır; dolayısıyla entegrasyonunuz dallanmaz, yalnızca kullanıcıya gösterilen yönerge değişir.
Bu, göründüğünden daha önemlidir. Yalnızca WhatsApp kullanan bir akış, düşük benimsenme olan pazarlardaki herkesi sessizce kaybeder; yalnızca SMS kullanan bir akış ise bir botun tetiklediği denemeler de dahil her deneme için bir operatöre ödeme yapar. İkisini tek oturumda tutmak, ucuz ve güvenli kanalı varsayılan yapmanıza ve yine de geri kalanlara ulaşmanıza olanak tanır.
Reverse OTP: yön neden önemli?
Geleneksel bir OTP akışında sunucu bir sır gönderir ve onun doğru cihaza ve yalnızca oraya ulaşacağını umar. SIM değiştirme saldırılarının ve OTP kimlik avının ikisinin de istismar ettiği varsayım budur ve yapay olarak şişirilmiş trafiği kârlı kılan da budur: arkada gerçek bir kullanıcı olsun olmasın her deneme size bir mesaja mal olur.
Reverse OTP bu varsayımı ortadan kaldırır. Kullanıcıya hiçbir sır gönderilmez; dolayısıyla araya girilecek, kimlik avıyla ondan koparılacak bir şey ve bir dolandırıcının size fatura edebileceği giden bir mesaj yoktur. Kullanıcının kendi gönderme eylemi kanıttır.
Doğrulama akışı, uçtan uca
Bir oturum pending durumunda başlar. Kullanıcı önceden doldurulmuş mesajı gördüğünde whatsapp_previewed, bağlantıyı açtığında opened ve mesaj ulaşıp oturumla eşleştiğinde verified aşamalarından geçer. Süresi içinde kimse işlem yapmazsa bunun yerine expired ile sona erer.
Telefon numarasını yalnızca verified durumu taşır; o zamana kadar alan null'dır. Durumu sinyal, numarayı onun yükü olarak ele alın, asla tersini değil: bu tek kural, insanların ilk entegre ederken karşılaştığı yarış koşullarının çoğunu ortadan kaldırır.
API'yi entegre etme
Entegrasyon iki REST çağrısından oluşur. POST /start-verification bir oturum açar ve WhatsApp numarasını, deep link'i ve kendi ekranınızı kurmak yerine yönlendirmeyi tercih ederseniz barındırılan bir web URL'sini döndürür. GET /check-verification-status oturumun durumunu ve doğrulandıktan sonra numaranın kendisini döndürür.
Arayüzü tamamen atlayıp barındırılan doğrulama sayfasını bir iframe'e gömebilirsiniz; bu, çalışan bir şeye giden en hızlı yoldur. Her iki durumda da üretimde polling döngüsü yerine callback'i tercih edin ve yalnızca geliştirme sırasında ya da kullanıcı açıkça sayfanıza döndüğünde polling yapın.
Güvenlik ve gizlilik
Oturumların ömrü kısadır ve her belirteç tam olarak tek bir oturuma bağlıdır; dolayısıyla yeniden oynatılan bir mesaj hiçbir şeyle eşleşmez. Aldığınız numara, kullanıcı girdisinden değil WhatsApp'ın kendi altyapısından gelir; bu da bir kullanıcının başkasının numarasını yazıp ele geçirdiği bir kodu beklemesi açığını kapatır.
Gizlilik açısından akış, yerini aldığı akıştan daha az kişisel veri taşır: kullanıcıya giderken hiçbir kod telekom ağından geçmez ve teslimat denemelerinin bir izini değil doğrulanmış numarayı saklarsınız.
Fiyatlandırma
Doğrulamalar ön ödemeli krediler olarak faturalandırılır. Abonelik yoktur ve kredilerin süresi dolmaz; dolayısıyla mevsimsel bir kayıt artışı ne tutuyorsa onu tutar, sakin bir ay ise hiçbir şeye mal olmaz. Yeni hesaplar ücretsiz kredilerle başlar; bu, herhangi bir taahhütte bulunmadan önce akışı bir staging ortamında uçtan uca çalıştırmaya yeter.
Sık sorulan sorular
- Telefon doğrulama API'si nedir?
- Telefon doğrulama API'si, bir kullanıcının telefon numarasını kontrol ettiğini kanıtlayan bir HTTP arayüzüdür. Bir doğrulama oturumu açmak için onu çağırır, döndürdüğü şeyi kullanıcıya gösterir ve kullanıcı işlem yaptıktan sonra doğrulanmış bir numarayı geri okursunuz.
- Telefon doğrulaması WhatsApp olmadan çalışır mı?
- Evet. Aynı oturum doğrulama belirtecini SMS ile de kabul eder; WhatsApp'ı olmayan kullanıcılar belirteci bunun yerine düz metin mesajı olarak gönderir. Entegrasyonunuz her iki durumda da sonucu aynı uç noktadan okur.
- Bir doğrulama ne kadar sürer?
- API çağrısının kendisi anlıktır; geri kalanı kullanıcının bir kodu taraması ve gönder'e dokunmasıdır. Pratikte oturumların çoğu dakikalar değil saniyeler içinde tamamlanır, çünkü beklenecek bir operatör teslimat adımı yoktur.
- Bir numara doğrulandığında API ne döndürür?
- Oturum durumu verified olarak değişir ve yanıt, doğrulanmış telefon numarasını geçtiği her adımın zaman damgalarıyla birlikte taşır. Bundan önce numara alanı null'dır.
- Telefon doğrulaması iki faktörlü kimlik doğrulamayla aynı şey mi?
- Hayır. Telefon doğrulaması numaranın kullanıcıya ait olduğunu, genellikle kayıtta bir kez kanıtlar. İki faktörlü kimlik doğrulama bu kanıtı girişte veya hassas bir işlemden önce yeniden kontrol eder. Aynı API ikisini de kapsar, ancak farklı soruları yanıtlarlar.
Related
Yaygın senaryolar
İletişim doğrulama
Kullanıcıların gerçek ve ulaşılabilir telefon numaraları verdiğini doğrulayın.
Müşteri kaydı
İlk günden doğrulanmış iletişim bilgileriyle güven oluşturun.
Numara doğrulama
Geçersiz, tek kullanımlık veya ulaşılamayan numaraları reddedin.
Kullanıcı kimliği teyidi
Güvenli kimlik kanıtlama için bir telefon numarasını kullanıcı profiline bağlayın.
Build your telefon doğrulama flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.