SMS API · REST + SMPP

Kritik mesajlar için REST veya SMPP üzerinden SMS API

Zamanınıza saygı duyan bir SMS API.

Bir SMS API, yazılımınızın tek bir HTTP isteği ile tek kullanımlık şifreler ve uyarılar gibi metin mesajları göndermesini sağlar: BroadNet ile kodunuz, bir Bearer token kullanarak POST /sms/sendSms'i çağırır veya yüksek hacimli veri akışları için SMPP üzerinden bağlantı (bind) kurar. OpenAPI 3.1 spesifikasyonunda belgelenmiştir. Resmi bir TypeScript SDK mevcuttur. Webhook ile iletim raporları sağlanır. Test erişimi talep edin.

API entegrasyonunuzu planlayın Test erişimi talep edin (İngilizce form)

ISO 27001 · 9001 · 22301GDPR & HIPAA uyumluSaniyenin altında p99

Teslimat rotalarına ayrılan tek bir API aramasının karşısındaki BroadNet kar leopardı

Canlı · tek bir API, tüm kanallar

API mesajlaşma

1 API

tüm kanallarda

1,000+

operatör bağlantıları

99.99%

SLA

API çalışma süresi

99.99%

Sözleşmeli aylık SLA, çoklu bölge

API gecikme süresi

<350ms

tüm bölgeler için p99 hedefi

Resmî SDK

TypeScript / Node.js + OpenAPI 3.1 spesifikasyonu

Ülkeler

200+

1.000'den fazla doğrudan operatör rotası

Tek bir istekte

POST isteğiniz ile
iletim raporu arasında neler yaşanır.

Bir TLS el sıkışması, beş mühendislik aşaması, iki webhook. Her aşamanın kendine ait bir gecikme bütçesi vardır — ve her bütçe pazarlama sayfasında değil, SLA'de yer alır.

01 · Talep
Uygulamanız · REST
TLS üzerinden POST /sms/sendSms, Bearer-token kimlik doğrulaması, JSON gövdesi: senderId, destinationNumber, message, messageType.
p50 < 41ms TTFB
02 · Edge
BroadNet API uç nokta
Token kontrolü, şema doğrulaması ve rota sorgulama — mesaj kimliği doğrudan yanıtta geri döner.
p50 < 60ms
03 · Router
Rota + kuyruk
Rota başına kalite puanı, en hızlı yasal SMPP bağlantısını seçer. Çok bölgeli active-active hata toleransı <800ms içinde gerçekleşir.
p50 < 10ms
04 · Bind
Operatör SMPP 3.4
Hedef MNO için doğrudan SMPP bağlantısı kurulur. submit_sm gönderilir; DLR korelasyonu için sıra numarası takip edilir.
p50 < 1.5s
05 · Webhook
İletim raporu
Mesaj ID'si ile eşleştirilen iletim raporu olarak deliver_sm yakalanır ve webhook URL'nize POST edilir.
p95 < 2s
← iletim raporu · webhook

01 · Talep

Uygulamanız · REST

TLS üzerinden POST /sms/sendSms, Bearer-token kimlik doğrulaması, JSON gövdesi: senderId, destinationNumber, message, messageType.

p50 < 41ms TTFB

02 · Edge

BroadNet API uç nokta

Token kontrolü, şema doğrulaması ve rota sorgulama — mesaj kimliği doğrudan yanıtta geri döner.

p50 < 60ms

03 · Router

Rota + kuyruk

Rota başına kalite puanı, en hızlı yasal SMPP bağlantısını seçer. Çok bölgeli active-active hata toleransı <800ms içinde gerçekleşir.

p50 < 10ms

04 · Bind

Operatör SMPP 3.4

Hedef MNO için doğrudan SMPP bağlantısı kurulur. submit_sm gönderilir; DLR korelasyonu için sıra numarası takip edilir.

p50 < 1.5s

05 · Webhook

İletim raporu

Mesaj ID'si ile eşleştirilen iletim raporu olarak deliver_sm yakalanır ve webhook URL'nize POST edilir.

p95 < 2s

Etkileşimli

API'yi deneyin

Bir istek doldurun, gönder butonuna basın ve simüle edilmiş yanıt ile iletim akışını — kayıt olmadan, hemen burada izleyin.

POSTapi.broadnet.me/sms/sendSms

Talep

Erişim belirteci (Bearer)

Authorization: Bearer $BROADNET_TOKEN

destinationNumber (ülke kodu, + içermez)Gönderici adı

MesajKodlama (Encoding)

request.sh

curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "senderId": "BroadNet",
      "destinationNumber": "447700900123",
      "message": "Your verification code is 482913",
      "messageType": "TEXT"
    }'

Yanıt

Örnek yanıt — mesaj gönderilmez

İsteği doldurun ve örnek bir yanıt görmek için Test isteği gönder butonuna basın.

Tamamen tarayıcınızda çalışır. Bu sayfadan hiçbir istek ayrılmaz ve hiçbir SMS gönderilmez.

Request test access Tam API referansı

Diliniz

Tek arama, yazmanın dokuz yolu.

Her sekme aynı isteği gönderir: Bearer token içeren POST /sms/sendSms ve senderId, destinationNumber, message ve messageType içeren bir JSON gövdesi. Yanıt gövdesi mesaj kimliğidir (message ID).

BroadNet'in TypeScript ve Node.js için tek bir resmi SDK'i vardır. Node.js, Python, PHP, Java, C#, Go ve Ruby sekmeleri, herhangi bir BroadNet paketi yüklemeye gerek kalmadan, standart HTTP kütüphaneleri ile doğrudan REST API'yi çağırır.

Tam API referansı

POST · api.broadnet.me/sms/sendSms

Example

1curl -X POST https://api.broadnet.me/sms/sendSms \
2  -H "Authorization: Bearer $BROADNET_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "senderId": "BroadNet",
6    "destinationNumber": "447700900123",
7    "message": "Your verification code is 482913",
8    "messageType": "TEXT"
9  }'
10 
11# 200 OK → response body is the message ID, e.g. 2603121407537573731

Protokoller

REST veya SMPP — protokolünüzü seçin

Çoğu ekip REST kullanır ve bir daha geri dönüp bakmaz. Yüksek hacimli operatörler, agregatörler ve eski sistemler SMPP 3.4 ile bağlanır. Aynı rotalar, aynı SLA, aynı panel — işinize en uygun arayüzü seçin.

REST · HTTPS

api.broadnet.me/sms/sendSms

Önerilen

HTTPS üzerinde JSON, TLS 1,3
Bearer-token kimlik doğrulaması — BroadNet hesabınızdan alınan token
POST /sms/sendSms · one path family per channel
Anında veya planlanmış gönderim
İletim raporları webhook adresinize iletilir
Tam referans /developers/api adresinde

Hız sınırları

Hesap başına sabit sınır yok

Maksimum veri yükü

1 MiB

SMPP 3.4

2775 düz · hesabınızla birlikte sağlanan TLS portu

Yüksek hacim

Binary SMPP v3.4 (talep üzerine v5.0)
Verici, Alıcı, Alıcı-Verici bağları
Hesap başına 32 adede kadar eşzamanlı bind
deliver_sm üzerinden DLR yönlendirme
TLS sarmalanmış bağlar, kimlik bilgisi başına IP izin listesi
Kurumsal seviyede düğüm başına saniyede 30.000 mesaja kadar veri iletim hızı

Düğüm başına

30k SMS/s

Yedekli çalışma

<800ms

Pencere

100 msg

Gerçekte ne alırsınız

Kendi başınıza inşa etmekten kurtulacağınız altı şey.

Güvenli yeniden denemeler

Kabul edilen her gönderim bir mesaj kimliği (message ID) döndürür. Ağ hatalalarında ve 5xx hatalarında bekleme süreli (backoff) yeniden deneme yapın ve körü körüne yeniden gönderim yapmak yerine mesaj kimliği üzerinden iletim raporlarıyla mutabakat sağlayın — arka plan işleyicileri (background workers) çökebilir ve temiz bir şekilde yeniden çalışabilir.

İletim webhook'ları

İletim raporları, REST ve SMPP trafiği için de webhook URL'nize iletilir ve mesaj ID'si ile eşleştirilir — kod yazmak için polling döngüsüne gerek kalmaz.

Eşzamanlı bağlantılar

Hesap başına 32 adede kadar paralel SMPP bind. REST üzerinde HTTP/2 multiplexing. Hesap başına sabit API hız sınırı yok — throughput trafiğinize göre ölçeklenir, bağlantı başına asla sınırlandırılmaz.

Otomatik hata aktarımı (Auto-failover)

Çok bölgeli active-active yapı. Bir rota kampanya sırasında bozulursa, 800 ms'den kısa sürede yeniden bağlar ve iletimdeki mesajları yeniden sıraya alır. Kendi SMPP yeniden bağlanma mantığınızı yazmanıza gerek kalmaz.

Sabit hız sınırı yok

Hesap başına sabit API hız sınırı yok — throughput trafiğinize göre ölçeklendirilir, düğüm başına 30.000 SMS/sn'ye kadar. Sessiz kısıtlama (throttling) veya shadow-banned numaralar yoktur — durumunuzu her zaman bilirsiniz.

OpenAPI 3.1 spesifikasyonu

Makine tarafından okunabilir, /developers/openapi.yaml. üzerinden sunulur. Resmi TypeScript SDK buradan oluşturulur; herhangi bir başka dilde istemci (client) oluşturun veya Postman ya da Insomnia sistemine içe aktarın.

Müşteri hikayeleri

Gerçek mühendislik ekiplerinin
API hakkındaki görüşleri.

Ubersöyledikleri. · MENA

Zorluk: Çok sağlayıcılı bir mesajlaşma yapısı, yeniden deneme yoğunluğu (retry storm) sırasında mükerrer OTP'lara neden oldu — bu uzun süredir devam eden bir hataydı. Yaklaşım: Tek bir gönderim yolu olan, yeniden denemelerin yalnızca ağ hatalarında ve 5xx hatalarında yapıldığı ve her gönderimin API tarafından döndürülen mesaj kimliği (message ID) ile takip edildiği BroadNet REST API yapısına geçiş yapıldı — bu işlem tek bir özellik bayrağı (feature flag) arkasında devreye alındı.

Baş mühendis, kimlik platformu

SamsungTüketici teknolojisi · APAC

Zorluk: Çok sayıda geliştiriciden oluşan bir mesajlaşma organizasyonu, sürümler arasındaki belgelenmemiş API değişiklikleri nedeniyle sürekli zaman kaybediyordu. Yaklaşım: OpenAPI 3.1 spesifikasyonu bir sözleşme olarak kabul ediliyor ve her sürümde CI üzerinde tiplendirilmiş istemciler (typed clients) yeniden oluşturuluyor.

Staff engineer, mesajlaşma platformu

American ExpressFinansal hizmetler · MENA

Zorluk: Dolandırıcılık ekibi, bir gönderime bağlayamadığı gelen teslimat olaylarına güvenmiyordu. Yaklaşım: Her iletim raporu, gönderim anında dönen mesaj kimliği ile eşleştirilir ve gönderici adı rotasyonu aynı akış içinde eritilir.

Engineering director, dolandırıcılık ve risk

1:1

DLR ↔ mesaj kimliği

Taşıyıcı

Her çağrıda token doğrulaması

Üretim için tasarlandı

Yazılı olarak taahhüt ettiğimiz rakamlar.

Bu hedefler kurumsal planlarda sözleşmeye bağlıdır, sadece birer hedef değildir. Bu hedeflere ulaşılamazsa, bir sonraki faturada aşağıdaki krediler otomatik olarak tanımlanır.

API çalışma süresi

99.99%

Aylık SLA

REST p99 gecikme süresi

<350ms

Hedef, tüm bölgeler

Webhook iletimi

<2s

p95 uçtan uca

Olay müdahalesi

<15 min

7/24 nöbetçi, severity-1 onaylama

Hizmet seviyesi taahhütleri

Tam SLA

Aylık API çalışma süresi

99.99%

%99,99'un altında %10 kredi · %99,0'ın altında %25 · %95,0'ın altında %50

REST p50 gecikme süresi

<100ms

Ağ çıkışı hariç, uç noktada

REST p99 gecikme süresi

<350ms

Tüm bölgelerde

Webhook iletimi

<2s p95

Hata durumunda 24 saate kadar üstel geri çekilme (exponential backoff)

SMPP bağlama kullanılabilirliği

99.99%

Bölgeler arası otomatik yedekleme ile bölge bazlı

Olay müdahalesi

<15 min

7/24 nöbetçi, severity-1 onaylama

Varsayılan olarak belgelenmiş

Kanıtlar.

Resmi TypeScript SDK, halka açık OpenAPI 3.1 spesifikasyonundan oluşturulur, böylece ikisi arasında hiçbir uyumsuzluk yaşanmaz. Herhangi bir başka dilde istemci (client) oluşturun veya spesifikasyonu Postman içine aktarın. Dokümantasyon, kodunuzun çalıştığı aynı staging ortamında çalışır.

npm · @broadnet/cpaas-sdk

Resmi TypeScript SDK

64her kanal özelliği için bir adet, API sınıfları

npm üzerinde görüntüleyin

broadnet.me/developers/openapi.yaml

OpenAPI 3.1 spesifikasyonu

329sekiz kanal genelinde yollar

Spesifikasyonu indirin

broadnet.me/developers

Dokümantasyon ve hızlı başlangıçlar

90skayıt aşamasından ilk gönderilen mesaja kadar

Dokümantasyonu okuyun

TypeScript SDKBearer-token kimlik doğrulamasıbroadnet.me/statusngrok uyumlu webhooklar

Alıcıların sorduğu sorular

Mühendislik soruları,
doğrudan yanıtlanır.

Test erişimi talep edin; test kimlik bilgilerinizle birlikte bir iş günü içinde size dönüş yapıyoruz. İlk test mesajınız, bu işlemden yaklaşık beş dakika sonra kendi doğruladığınız numaraya ulaşır. Canlı trafik, bizim tarafımızdaki herhangi bir süreçten ziyade, düzenleyici kurum nezdindeki gönderici adı kaydı sürecine bağlı olarak genellikle 5–15 iş günü içinde başlar.

Yalnızca ağ hatalarında ve 5xx hatalarında, üstel geri çekilme (exponential backoff) ile yeniden deneyin ve kabul edilen her gönderim için API tarafından döndürülen mesaj kimliğini (message ID) koruyun. Körleme yeniden denemeler yerine, yeniden göndermeden önce mesaj kimliği üzerinden iletim raporlarıyla mutabakat yapın ve düşük bakiye trafiği engellemeden önce kredinizi tamamlayın.

Gerçek. /developers/openapi.yaml'daki (/developers/openapi.json'de JSON) OpenAPI 3.1 spesifikasyonu; SMS, WhatsApp, RCS, Telegram, Push, E-posta, Messenger ve Instagram dahil olmak üzere her kanalı belgeler. Resmi TypeScript SDK (@broadnet/cpaas-sdk) buradan oluşturulur ve bize sormadan başka herhangi bir dilde kendi istemcinizi oluşturabilirsiniz.

API ücreti yoktur; mesaj başına, ülke başına ve rota başına ödeme yaparsınız. BAE işlem mesajları 0,0123 $/MT'den, Suudi Arabistan 0,016 $ ve Mısır 0,028 $ seviyesinden başlar. SMPP bind'leri kurumsal pakete dahildir; standart pakette her özel bind aylık 250 $'dır. Test erişimi talep üzerine sağlanır ve test trafiği günlük 1.000 mesaj ile sınırlandırılmıştır.

24 saat boyunca üstel geri çekilme (exponential backoff) ile yeniden deneme yapıyoruz: 30s, 2m, 10m, 30m, 2h, 8h, 24h. Her yeniden deneme bir X-Webhook-Attempt başlığı içerir. 24 saat sonra olay, dead-letter kuyruğuna (DLQ) alınır; panel üzerinden tek tıkla sorgulanabilir ve tekrar oynatılabilir. Standart paketlerde DLQ 7 gün, kurumsal paketlerde ise 90 gün saklanır.

Evet — rotalama, DLR'ler, faturalandırma ve paneller ortaktır. Çoğu müşteri aynı hesap üzerinden işlemsel mesajlar için REST, yüksek hacimli pazarlama için ise SMPP kullanır; her iki yoldan gelen iletim raporları da aynı raporlara ve webhook'lara düşer.

Atanmış teknik hesap yöneticisi, aylık ücret üzerinden hizmet kredisi sağlayan %99,99 API çalışma süresi SLA'sı (%99,99'un altında %10, %99,0'ın altında %25, %95,0'ın altında %50), <15 dakikalık sev-1 onay süreli 7/24 NOC çağrı sistemi, özel SMPP bağlantıları, üç aylık mimari incelemeler ve mühendislik ekibiyle paylaşılan bir Slack kanalı.

broadnet.me/status üzerinden bileşen durumlarını ve paylaşılan olayları görüntüleyebilirsiniz. Bu sayfa henüz canlı izleme verileriyle beslenmediği için 90 günlük geçmişi ölçümsel değil, örneklendirme amaçlıdır; sözleşmeli değer %99,99 çalışma süresi SLA'sıdır.

Sorunuz burada yok mu? Mühendislik ekibimize sorun

SMS API, bir giriş noktasıdır geniş kapsamlı A2P SMS platformu. Aynı doğrudan operatör rotaları ayrıca toplu SMS kampanyalarını da, OTP ve çok kanallı doğrulamave WhatsApp Business API.

Sağlayıcıları mı değerlendiriyorsunuz? Okuyun: 2026'nın En İyi SMS API'si satın alma kılavuzu.

Operatör sınıfı teslimat

Teslimat: 200+ ülke, operatöre doğrudan 86.

Gri rota yok: ticari olarak mümkün olan her yerde doğrudan operatör bağlantısı, aksi takdirde açıkça etiketlenmiş, iş ortağı tarafından yönetilen bir rota. 2003'ten beri kurulan bir ağ üzerinde her kanala tek API.

200+

Ülkeler

1,000+

Operatör bağlantıları

300M+

Mesaj·gün

Satış ekibiyle görüşün

Test erişimi · bir iş günü içinde yanıt

SMS sağlayıcınızla sorun yaşamayı bırakın.
Gönderime başlayın.

Tek bir erişim token'ı, resmi bir TypeScript SDK ve tek bir ekrana sığan hızlı başlangıç kılavuzu. Kayıt aşamasından ilk iletim raporunuza giden en hızlı yol.

API entegrasyon yolunu inceleyin Geliştirici katılım sürecini talep edin

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{"senderId":"BroadNet", …}'

Kaynaklar

SMS API veri sayfası

Teknik dokümanı indirin· PDF, 101 kB Ürün veri sayfaları

İlgili kılavuzlar ve yanıtlar

Bu ürünün arkasındaki kavramları daha derinlemesine inceleyin.

Kritik mesajlar için REST veya SMPP üzerinden SMS API

POST isteğiniz ile
iletim raporu arasında neler yaşanır.

API'yi deneyin

Tek arama, yazmanın dokuz yolu.

REST veya SMPP — protokolünüzü seçin