---
title: "Doğrulama kodları için OTP SMS API"
description: "Bearer token ile tek bir REST çağrısıyla OTP SMS gönderin; Unicode ve Arapça desteği, kayıtlı SMS başlıkları, webhook iletim durumları ve sesli arama yedeği dahil."
canonical: "https://omnichannels.ai/tr/channels/sms/otp-api/"
language: "tr"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Doğrulama kodları için OTP SMS API

Canonical: https://omnichannels.ai/tr/channels/sms/otp-api/
Language: tr
Publisher: OmniChannels.ai by BroadNet Technologies

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.

**Kısa yanıt:** 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

| Öğ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.

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

Güncelleme: 2026-10-10