Kullanıcıyı doğrulayan kodu üret, gönder ve kontrol et.
OTP SMS; üye girişi, kayıt ve ödeme adımlarında tek kullanımlık kod göndermek için kullanılır. Kod üretimi ve doğrulaması REST uç noktalarıyla yapılır.
İki istek: gönder, doğrula
curl -X POST https://basliklisms.com/api/v1/otp/send \
-H "X-API-Key: bsl_live_..." \
-H "Content-Type: application/json" \
-d '{"phone": "05XXXXXXXXX", "brand": "Firmam"}'curl -X POST https://basliklisms.com/api/v1/otp/verify \
-H "X-API-Key: bsl_live_..." \
-H "Content-Type: application/json" \
-d '{"id": "otp-...", "code": "123456"}'- Kod yanıtta dönmez; yalnızca kullanıcının telefonuna gider.
- Varsayılan geçerlilik 180 saniye, en fazla 5 doğrulama denemesi.
- Her gönderim 1 kredi; sağlayıcı reddederse kredi iade edilir.
Neler var?
Kod üretimi ve doğrulama
Kod üretimi ile doğrulama ayrı uç noktalardır. Doğrulama sonucu sisteminize döner; kod hiçbir adımda düz metin olarak saklanmaz.
Geçerlilik süresi
Kod 180 saniye geçerlidir. Süre dolduğunda aynı kod doğrulanamaz; kullanıcı yeni kod istemek zorundadır.
Deneme sınırı
Üç hatalı denemeden sonra kod geçersiz sayılır. Böylece kodu tahmin etmeye yönelik tekrarlı denemeler engellenir.
Gönderim sıklığı kontrolü
Aynı numaraya 45 saniye içinde ikinci kod gönderilemez. SMS bombardımanı ve gereksiz kredi harcaması önlenir.
OTP kayıtları
Üretilen ve doğrulanan kodlar kayıt altındadır. Kayıtları panelden numara ve durum bilgisiyle sorgulayabilirsiniz.
Başlık ve amaç bilgisi
Kod gönderimi başlık ve amaç (giriş, kayıt, ödeme) bilgisiyle yapılır; hangi amaçla gönderildiği kayıtta görünür.
Kurulum ve gönderim adımları
- 01
API anahtarı oluşturun
Panelden API anahtarı üretin. Anahtar; gönderim, OTP ve raporlama uç noktalarında kimlik doğrulaması için kullanılır.
- 02
Üretim isteği gönderin
POST /api/v1/otp/generate isteğiyle telefon numarasına kod üretin ve gönderin.
- 03
Kodu doğrulayın
Kullanıcının girdiği kodu POST /api/v1/otp/verify uç noktasına gönderin; sonucu kendi akışınıza bağlayın.
- 04
Kayıtları izleyin
OTP kayıtlarından üretim ve doğrulama geçmişini numara, durum ve zaman bilgisiyle inceleyin.
Bu ürüne özel sorular
01OTP kodunu kendim belirleyebilir miyim?
Kod sistem tarafından üretilir. Paneldeki simülatörde test kodunu görebilirsiniz; canlı gönderimde kod yalnızca alıcının telefonuna gider.
02Aynı numaraya kaç kez kod gönderilebilir?
İki kod isteği arasında 45 saniye beklenir. Kod üç hatalı denemede geçersiz olur ve yeniden kod istenmesi gerekir.
03Kodu kendi doğrulama akışıma nasıl bağlarım?
Doğrulama uç noktası başarılı veya başarısız sonucu döner. Bu sonucu kayıt, giriş veya ödeme adımınıza bağlarsınız; kod doğrulaması kendi tarafınızda tutulmaz.
04OTP gönderimleri raporlarda görünür mü?
Evet. OTP kayıtları ayrı listelenir; toplu kampanya raporlarıyla karışmaz, numara ve durum bilgisiyle sorgulanır.