Doğrulama kodları için OTP SMS API
Tek kullanımlık şifreleri arka ucunuzdan BroadNet REST API'sine tek bir HTTPS isteğiyle gönderin. Kodu uygulamanız üretir ve doğrular; biz kayıtlı bir SMS başlığından doğrudan operatör rotalarıyla iletir, her durumu webhook'unuza bildiririz.
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "971500000000",
"message": "482913 is your OmniDemo code. It expires in 5 minutes. Do not share it.",
"messageType": "TEXT",
"campaignName": "login-otp"
}'
# 200 OK
2603121407537573731SMS API ile OTP gönderimi. Token, SMS başlığı ve numara yer tutucudur.
Kısa yanıt
Güncelleme
OmniChannels.ai ile SMS üzerinden OTP göndermek için arka ucunuz kodu üretir ve https://api.broadnet.me adresindeki POST /sms/sendSms uç noktasını bearer token, SMS başlığı, numara ve mesajla çağırır. API bir mesaj kimliği döndürür, iletim durumları webhook'unuza ulaşır. Unicode ve Arapça desteklenir; WhatsApp veya sesli arama yedek olarak kullanılabilir.
OTP SMS API geliştiricilere ne sunar
Kod başına tek REST çağrısı
JSON gövdesi ve bearer token ile POST /sms/sendSms. Yanıt, doğrulama denemesiyle ilişkilendirip sakladığınız mesaj kimliğidir.
Webhook ile iletim durumları
SUBMITTED, SENT, DELIVERED, FAILED ve REJECTED durumlarını tek bir normalleştirilmiş biçimde alın; yeniden gönderim veya kanal değişimi için doğru anı bilirsiniz.
Unicode ve Arapça kodlar
Arapça veya diğer alfabeler için messageType değerini UNICODE yapın. POST /sms/identify, göndermeden önce kodlamayı ve segment sayısını döndürür.
Kayıtlı SMS başlıkları
BAE ve Suudi Arabistan gibi gerektiren pazarlarda, işlemsel trafik için kayıtlı alfanümerik bir SMS başlığından gönderin.
Göndermeden önce numara sorgusu
POST /sms/lookup bir numarayı ağ üzerinden (HLR ve MNP) kontrol eder; kod göndermek için ödeme yapmadan geçersiz numaraları elemenize yardımcı olur.
WhatsApp ve sesli arama yedeği
SMS iletilmediğinde veya kod girilmediğinde bir WhatsApp kimlik doğrulama şablonuna ya da sesli aramaya geçin.
Çok yüksek hacim için SMPP
Zaten bir SMPP istemciniz varsa, OTP'leri aynı rotalar üzerinden TLS'li SMPP 3.4 ile gönderin ve makbuzları oturum üzerinden alın.
SDK ve MCP sunucusu
TypeScript SDK'sı @broadnet/cpaas-sdk'yı, OpenAPI 3.1 şemasını veya yapay zeka ajanları için MCP sunucusunu kullanın.
Kodunuz ne yapar, API ne yapar
Net bir ayrım doğrulamayı güvenli tutar: kod sizin sisteminizde, iletim platformdadır.
| Öğe | Ayrıntılar |
|---|---|
| Kodu üretin | Arka ucunuz rastgele bir kod üretir, geçerlilik süresiyle birlikte hash'ini saklar ve numara, cihaz ve IP adresi başına denemeleri sınırlar. |
| SMS'i gönderin | senderId, destinationNumber (ülke kodu artı numara, yalnızca rakam), message ve messageType ile POST /sms/sendSms. |
| İletimi izleyin | Dönen mesaj kimliğini saklayın ve webhook durumlarını onunla eşleştirin. Zaman aşımınız içinde DELIVERED gelmemesi bir yedeklemeyi tetikleyebilir. |
| Kodu doğrulayın | Arka ucunuz kullanıcının yazdığını saklanan hash ile karşılaştırır. Platform doğrulama durumunuzu asla kontrol etmez veya saklamaz. |
| Yedeğe geçin | Kimlik doğrulama şablonuyla WhatsApp'tan ya da ekibimizin sizinle birlikte devreye aldığı sesli aramayla yeniden gönderin. |
| Fiyatlandırma | Hedefe göre SMS segmenti başına, BroadNet'in yayımlanmış liste fiyatlarıyla ücretlendirilir; kurulum ücreti ve aylık asgari tutar yoktur. Ülke bazında SMS fiyatlarına bakın. |
OTP SMS API nasıl entegre edilir
- 1
Token'ınızı alın
Erişim talep edin; hesabınız için bir bearer token verilir ve test mesajları kendi doğrulanmış numaralarınıza gider.
- 2
SMS başlığı kaydettirin
İşlemsel bir SMS başlığı seçin ve yayına almadan önce gerektiren ülkelerde kaydettirin.
- 3
Mesajı yazın
Kodu başa koyun, markanızı belirtin, geçerlilik süresini yazın ve paylaşmama uyarısı ekleyin. Tek segmentte tutun.
- 4
Gönderin ve izleyin
POST /sms/sendSms çağırın, mesaj kimliğini saklayın ve webhook durumlarını idempotent şekilde işleyin.
- 5
Yedekleme ve limit ekleyin
Sonraki adım olarak WhatsApp veya sesli aramayı ekleyin; yayından önce SMS pumping'i engellemek için istekleri hız sınırına tabi tutun.
OTP SMS API ne zaman doğru tercih
Şu durumlarda iyi bir seçim
- Kayıt, giriş veya ödeme doğrulamasını kendi uygulamanıza kuruyor ve kodun tam kontrolünü istiyorsunuz.
- BAE, Suudi Arabistan ve diğer Körfez ile MENA pazarlarına Arapça ve İngilizce OTP göndermeniz gerekiyor.
- Şimdi SMS, ileride WhatsApp, RCS veya sesli yedekleme için tek API istiyorsunuz.
- REST ve webhook'ları tercih ediyor, hacimler büyüdüğünde SMPP'yi de kullanabilmek istiyorsunuz.
Başlamadan önce bilmeniz gerekenler
- Barındırılan bir doğrulama uç noktası yoktur: kodu uygulamanız üretir, saklar ve kontrol eder.
- Üretim erişimi ekibimiz tarafından incelenir; anında self servis kayıt yoktur.
- SMS başlığı kaydı bazı ülkelerde günler sürer; bu yüzden yayın tarihinizden önce başlatın.
- OTP uç noktaları SMS pumping dolandırıcılığının hedefidir; ülke izin listeleri, hız limitleri ve bot kontrolleri uygulamadaki sorumluluğunuzdur.
Kanal yedeklemesi, adım adım
Platform veya API üzerinden bir kez gönderin. Bir adım zamanında iletilmezse sıradaki kanal otomatik olarak devralır ve her durum tek bir webhook biçiminde geri döner.
- 01
WhatsApp
Düğmeli zengin şablon, okundu bilgisi ve gelen kutusunda yanıtlar
- 02
RCS
Cihaz ve operatörün RCS'i desteklediği yerde markalı zengin kart
- 03
SMS
Doğrudan operatör rotalarıyla her cep telefonuna ulaşır
- 04
Ses
Metin ulaşmadığında sesli kod veya mesaj
OTP SMS API hakkında sorular
API ile OTP SMS nasıl gönderilir?
Kodu arka ucunuzda üretin, ardından Authorization: Bearer başlığı ve senderId, destinationNumber, message ile messageType içeren bir JSON gövdesiyle POST https://api.broadnet.me/sms/sendSms çağırın. Yanıt mesaj kimliğidir, iletim durumları webhook'unuza gelir.
API kodu benim için üretir ve doğrular mı?
Hayır. Kodu uygulamanız üretir, geçerlilik süresiyle hash'ini saklar ve kullanıcının girdiğini kontrol eder. Doğrulamayı kendi sisteminizde tutmak, kod mantığının, deneme limitlerinin ve denetim izinin sizin kontrolünüzde kalması demektir.
OTP SMS'i Arapça gönderebilir miyim?
Evet. messageType değerini UNICODE yapın. Arapça SMS segment başına 70 karaktere sığar; mesajı kısa tutun. Kodlamayı ve segment sayısını öğrenmek için önce POST /sms/identify çağırabilirsiniz.
En iyi OTP SMS mesaj biçimi nedir?
Kodla başlayın, markanızı belirtin, geçerlilik süresini yazın ve kullanıcıyı kodu asla paylaşmaması konusunda uyarın; hepsi tek segmentte. İşlemsel bir SMS başlığı kullanın ve teklifleri dışarıda tutun; böylece ağlar mesajı pazarlama olarak filtrelemez.
OTP SMS iletilmezse ne yapmalıyım?
Mesaj kimliği için webhook durumlarını izleyin. DELIVERED görmüyorsanız veya kullanıcı kodu zaman aşımı süreniz içinde girmiyorsa yeniden gönderim sunun ya da WhatsApp veya sesli aramaya geçin. Aynı numaraya sonsuza dek yeniden denemeyin.
OTP uç noktamı SMS pumping'e karşı nasıl korurum?
Yalnızca hizmet verdiğiniz ülkelere izin verin, numara, cihaz ve IP adresi başına hız sınırı koyun, herkese açık formlara bot kontrolü ekleyin ve olağandışı önekli isteklerde ani artışlarda uyarı alın. Göndermeden önce numara sorgusu da geçersiz numaraları elemeye yardımcı olur.
Bir OTP SMS ne kadara mal olur?
OTP SMS, hedefin tarifesiyle segment başına ücretlendirilir. BroadNet'in ülke bazında gösterge niteliğindeki liste fiyatları SMS fiyat sayfalarındadır; örneğin BAE'ye segment başına 0,0123 ABD dolarından başlar. Kurulum ücreti veya aylık asgari tutar yoktur; fiyatları teklifiniz teyit eder.
Sandbox var mı?
Test erişimi aynı API üzerinden kendi doğrulanmış numaralarınıza gönderir; böylece üretimden önce gerçek iletimi ve durumları test edersiniz. Ayrı bir herkese açık sandbox ve anında self servis kayıt yoktur.
Bu konudaki rehberler
- SMS ve OTPWhatsApp ve SMS OTP Mesajları: Güvenlik ve Dolandırıcılık9 dk okuma
- SMS ve OTPSMS Pumping Dolandırıcılığı: AIT ve Nasıl Durdurulur9 dk okuma
- EntegrasyonMesajlaşma API Entegrasyonu: REST, SMPP ve Webhook9 dk okuma
Platformun diğer özelliklerini keşfedin
OTP SMS için API erişimi alın
Ülkelerinizi, beklenen doğrulama hacimlerinizi ve SMS başlığınızı bize iletin. Kendi numaralarınıza test için bir token verir ve SMS başlığı kaydında yardımcı oluruz.
Yazılım yığınınızı ve neyi bağlamak istediğinizi paylaşın. Bir çözüm mühendisi sizinle iletişime geçecek.