# İlk test SMS'inizi kimlik bilgilerini aldıktan beş dakika sonra gönderin. - Kanonik URL: https://www.broadnet.me/tr/developers/quickstart - Dil: tr - Son güncelleme: 2026-10-21 - Yayıncı: BroadNet (https://www.broadnet.me) - Yukarıdaki sayfanın, görüntülenen sayfadan oluşturulmuş Markdown sürümü. Geliştirici hızlı başlangıç kılavuzu Test erişimi talep edin; bir iş günü içinde test kimlik bilgilerinizle yanıt verelim. Ardından token'ı alın, TypeScript SDK'yı kurun ve şunu çağırın: `smsSendsmsPost`. İlk test mesajınız, kimlik bilgilerini aldıktan yaklaşık beş dakika sonra kendi doğruladığınız numaraya ulaşır. Aşağıdaki tüm örnekler kopyalanmaya hazırdır ve 5. adım, canlıya geçişten önce nelerin kontrol edilmesi gerektiğini kapsar. [Test erişimi talep edin (İngilizce form)](https://www.broadnet.me/tr/contact?intent=test-access) [Tam API referansı](https://www.broadnet.me/developers/api) İlerleme 0 / 5 adım · 5 dk 0/5 Kalan adımlar 5 1. Erişim token'ınızı alın Adım 1 · 30 sec 2. SDK kurulumunu yapın Adım 2 · 45 sec 3. İlk mesajınızı gönderin Adım 3 · 60 sec 4. İletim durumunu alın Adım 4 · 90 sec 5. Canlıya geçişten önce Adım 5 · beş dakikanın bir parçası değil Talep aşamasından canlıya geçişe ## İlk mesajınıza giden tek yol, her adımın süresiyle birlikte. 1. 01 Test erişimi talep edin 1 iş günü içinde yanıt verilir Bir mesajlaşma mühendisi, test kimlik bilgilerinizle birlikte size yanıt verir ve ülkeleriniz, hacimleriniz ve kullanım durumunuz üzerine 30 dakikalık bir görüşme planlar. 2. 02 İlk test mesajı Kimlik bilgilerinden yaklaşık 5 dakika sonra Hızlı başlangıç koduyla kendi doğruladığınız numaranıza bir test mesajı gönderin. İletim raporu webhook adresinize iletilir. 3. 03 Entegrasyon 2–5 iş günü Kod örnekleriyle aynı uç noktaya karşı kendi test kimlik bilgilerinizle kurulum yapın ve test edin. REST veya SMPP üzerinde bir BroadNet mühendisi size eşlik eder. 4. 04 Onay 3–10 iş günü Gönderici kimliği, trafik amacı ve hedef kuralları incelenir ve entegrasyonunuzla eş zamanlı olarak gönderici adları her bir düzenleyici kurum nezdinde kaydedilir. 5. 05 Canlı ortam Geçiş günü Hesabınız için üretim erişimi ve rotalar etkinleştirildi. Entegrasyonunuz halihazırda https://api.broadnet.me ortamını çağırıyor. Genel olarak: Çoğu pazar için talepten canlıya geçiş süreci 5–15 iş günüdür; bir düzenleyicinin gönderici adı için gereken ön hazırlık süresi daha uzun olan pazarlarda bu süre uzayabilir. Diyagram Bir A2P mesajının telefona ulaşma süreci 1. Uygulamanız REST API veya SMPP üzerinden gönderilir 2. BroadNet platformu Her mesajı doğrular, yönlendirir ve faturalandırır 3. Operatör SMSC’si Doğrudan operatör bağlantısı 4. Abone cihazı Mesaj iletilir İletim raporu (DLR), aynı yol üzerinden webhook'unuza geri döner Bu sayfada 1. 01 Erişim token'ınızı alın 2. 02 SDK kurulumunu yapın 3. 03 İlk mesajınızı gönderin 4. 04 İletim durumunu alın 5. 05 Canlıya geçişten önce Kimlik bilgilerinden sonra 5 dk Test kimlik bilgilerinden ilk test mesajına kadar yaklaşık beş dakika. Webhook adımı için genel bir URL gereklidir; ngrok sorunsuz çalışır. 01 Adım 1 · 30 sec ## Erişim token'ınızı alın. Erişim token'ınız test kimlik bilgilerinizle birlikte gelir: test erişimi talep edin, bir iş günü içinde yanıt verelim. Token'ı BROADNET_TOKEN ortam değişkeninde saklayın ve her çağrıda Authorization: Bearer başlığıyla gönderin. Bu sayfadaki tüm örnekler üretim temel URL'si olan https://api.broadnet.me adresini kullanır. BroadNet hesabınız · erişim belirteci Erişim belirteci quickstart-default active 84f1a02e3c7d4b91a7e0•••••••••••• copy Üst Bilgi Bearer Ortam değişkeni BROADNET_TOKEN Temel URL (Base URL) api.broadnet.me $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" … 200 OK Test edin POST /sms/sendSms ile kendi doğrulanmış numaranıza test SMS gönderin. Gövdesi bir mesaj kimliği (message ID) olan 200 OK yanıtı, başka bir kod yazmadan önce token'ın çalıştığını onaylar. step 1.broadnet.me 02 Adım 2 · 45 sec ## SDK kurulumunu yapın. BroadNet'in TypeScript ve Node.js için tek bir resmi SDK'ı vardır: npm install @broadnet/cpaas-sdk axios. Bu, BroadNet OpenAPI spesifikasyonundan oluşturulmuştur. Diğer tüm dillerde, alışılagelmiş HTTP kütüphanenizle REST API'yi çağırabilir veya OpenAPI spesifikasyonundan bir istemci oluşturabilirsiniz. Kur ``` npm install @broadnet/cpaas-sdk axios export BROADNET_TOKEN=your_access_token ``` bash node >= 18 Test edin @broadnet/cpaas-sdk üzerinden Configuration ve SMSSMSApi bileşenlerini içe aktarın. İçe aktarma işlemi tamamlanır ve tip kontrolünden geçerse, gönderime hazırsınız demektir. step 2.broadnet.me 03 Adım 3 · 60 sec ## İlk mesajınızı gönderin. Temel URL'niz ve token'ınız ile bir SMSSMSApi oluşturun, senderId, destinationNumber, message ve messageType parametreleriyle smsSendsmsPost fonksiyonunu çağırın ve sonucu günlüğe kaydedin. Yanıt gövdesi mesaj ID'sidir; iletim durumunu daha sonra eşleştirmek için bu ID'yi saklayın. POST /sms/sendSms ``` // npm install @broadnet/cpaas-sdk axios import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk"; const sms = new SMSSMSApi( new Configuration({ basePath: "https://api.broadnet.me", accessToken: process.env.BROADNET_TOKEN!, }), ); const res = await sms.smsSendsmsPost({ sMSSmsRequest: { senderId: "BroadNet", destinationNumber: "447700900123", message: "Your verification code is 482913", messageType: "TEXT", }, }); console.log(res.data); // message ID ``` javascript 200 OK · mesaj kimliği Yanıt · 200 OK gövde · mesaj kimliği ``` HTTP/1.1 200 OK 2603121407537573731 ``` Test edin Elinizdeki telefonu kontrol edin. Eğer SMS aldıysanız, en zor kısmı tamamladınız — aşağıdakilerin tamamı operasyonel iyileştirmedir. step 3.broadnet.me 04 Adım 4 · 90 sec ## İletim durumunu alın. BroadNet, iletim durumunu hesabınızda yapılandırılan webhook URL'sine iletir: Okunma raporu sunan kanallarda SUBMITTED, SENT, DELIVERED, READ veya FAILED ve REJECTED durumları iletilir. Her güncellemeyi kaydedin, hızlıca 2xx yanıtı verin ve işlemi asenkron olarak işleyin. POST /webhooks/broadnet ``` import express from "express"; const app = express(); app.post("/webhooks/broadnet", express.json(), async (req, res) => { // Store the status update first, then acknowledge with a 2xx. // Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED. await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body }); res.sendStatus(200); }); ``` javascript iletim durumu · JSON DELIVERED Cihaz üzerinde onaylandı. Mesaj ağ üzerinden ilerlerken SUBMITTED ve SENT gibi önceki güncellemeler gelir. iletildikten sonra READ Alıcı tarafından, WhatsApp gibi okundu bilgisi veren kanallar üzerinden açıldı. okunduğunda BAŞARISIZ / REDDEDİLDİ İletilemedi. Tekrar göndermeden önce numara formatını ve gönderici adınızı kontrol edin. nihai durum Test edin Telefonunuza bir mesaj gönderin, ardından iletim durumunun DELIVERED olarak güncellenip güncellenmediğini kontrol etmek için sunucu günlüğünüzü inceleyin. step 4.broadnet.me 05 Adım 5 · beş dakikanın bir parçası değil ## Canlıya geçişten önce. Onay süreci tamamlandığında üretim ortamı açılır: gönderici kimliği, trafik amacı ve gönderici adları; entegrasyonunuzla eş zamanlı olarak 3–10 iş günü sürer. Onay alındıktan sonra aynı kod üretim trafiğini gönderir. Bu aşamaya kadar token'ı kaynak kontrolünde (source control) tutmayın, iletim durumu webhook'larını kurun ve yeniden deneme politikanızı belirleyin. - 01 Gizli bilgileri kendi ortamınıza taşıyın BROADNET_TOKEN'ı bir ortam değişkeninde veya secrets manager'ınızda tutun; asla kaynak kontrolünde veya istemci tarafı kodunda bulundurmayın. Sızması durumunda derhal değiştirin. - 02 Güvenle tekrar deneyin ve bakiyenizi takip edin Ağ hatalarını ve 5xx yanıtlarını üstel geri çekilme (exponential backoff) ile tekrar deneyin. Kabul edilen her gönderim bir mesaj kimliği (message ID) döndürür; bu nedenle körü körüne yeniden göndermek yerine, bu kimliği kaydedin ve iletim durumunu kontrol edin. Toplu SMS gönderimlerinde, her yanıtta kalan krediniz raporlanır. - 03 SDK sürümünü sabitleyin package.json dosyasında API/cpaas-sdk paketini belirli bir sürüme sabitleyin ve güncellemeleri bilinçli olarak yapın. API yolları herhangi bir sürüm ön eki taşımaz, bu nedenle değişiklikleri changelog ve OpenAPI spesifikasyonundan takip edin. - 04 Hataları durum koduna göre yönetin Hatalar bir HTTP durum kodu ve status, error, message, errorCode ve requestUri içeren bir ExceptionResponse gövdesi döndürür. 400 ve 401 hatalarını düzeltin; 5xx hatalarını ise bekleme süresi (backoff) uygulayarak tekrar deneyin. - 05 Yeniden deneme politikanızı belirleyin Varsayılan: 5xx ve ağ hatalarında üstel geri çekilme (exponential backoff) uygulanır, 4xx hatalarında uygulanmaz. Zaman aşımından sonra, ilk istek halihazırda kabul edilmiş olabileceği için tekrar göndermeden önce iletim durumunu kontrol edin. Test edin Aşağıdaki kontrol listesini kodunuz üzerinde uygulayın. Tüm kutucuklar işaretlendiğinde, onay süreci tamamlanır tamamlanmaz entegrasyonunuz canlıya geçmeye hazır olacaktır. step 5.broadnet.me İlk günden itibaren production için tasarlandı ## Aynı kod yapıları günde 300 milyondan fazla mesajı işliyor. Test trafiğiniz bir simülasyon değildir. Yukarıdaki adımlarda yapılandırdığınız her istek, anahtar ve webhook; kurumsal trafiğimizi taşıyan aynı yönlendirme, faturalandırma ve uyumluluk katmanından geçer — bu süreçler aşağıda belirtilen sertifikalar kapsamında her yıl denetlenmektedir. ISO 27001 Bilgi güvenliği ISO 9001 Kalite yönetimi ISO 22301 İş sürekliliği GDPR Uyumlu · AB veri yerleşimi HIPAA Uyumlu · Talep üzerine BAA SOC 2 Tip II · yıllık denetim AB + BAE veri yerelliği %99,99 API çalışma süresi SLA'sı Test ve canlı ortam için tek bir temel URL İletim durumu webhook'ları Alıcıların sorduğu sorular ## Hızlı başlangıç soruları Authorization: Bearer başlığı ve senderId, destinationNumber, message ve messageType (TEXT veya UNICODE) içeren JSON gövdesine sahip bir POST https://api.broadnet.me/sms/sendSms gönderin. Yanıt, mesaj kimliğidir (message ID). /websmpp altındaki eski HTTP API, SMPP dönemi entegrasyonları için hâlâ mevcuttur. /signup üzerinden test erişimi talep edin; BroadNet mühendisi, bir iş günü içinde test kimlik bilgilerinizle birlikte size dönüş yapacaktır: Authorization: Bearer başlığında göndermeniz gereken erişim belirteci ve test trafiğini nereye göndereceğiniz bilgisi. İlk test mesajınız, bu bilgileri aldıktan yaklaşık beş dakika sonra gönderilebilir. Tek bir resmi SDK vardır: npm'de TypeScript ve Node.js için @broadnet/cpaas-sdk. Diğer tüm dillerde REST API'yi doğrudan HTTPS üzerinden çağırabilir veya OpenAPI spesifikasyonundan (/developers/openapi.yaml) bir istemci oluşturabilirsiniz. Sorunuz burada yok mu? [Mühendislik ekibimize sorun](https://www.broadnet.me/tr/contact) Test erişimi · bir iş günü içinde yanıt ## Beş adım kaldı. Gitmek için tek bir anahtar. Kendi doğrulanmış numaralarınızla test yapın, entegrasyonu tamamlayın ve ardından aynı konsol üzerinden canlı trafiğe geçin. Günde 300 milyondan fazla mesaj taşıyan aynı SDK, aynı uç noktalar (endpoints) ve aynı SLA'lar. [Test erişimi talep edin (İngilizce form)](https://www.broadnet.me/tr/contact?intent=test-access) [Tam API referansı](https://www.broadnet.me/developers/api) $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{ "senderId": "…", "destinationNumber": "…", "message": "…", "messageType": "TEXT" }'