Bilmeniz gereken her şey, gereksiz hiçbir şey yok.
İstek
BroadNet ağ geçidi, bir Authorization: Bearer token ve bir JSON gövdesi içeren bir POST isteğini https://api.broadnet.me/sms/sendSms'e kabul eder: senderId (gönderici adı), destinationNumber (uluslararası formatta hedef numara, sadece rakamlar, artı işareti yok), message (metin) ve messageType (GSM-7 için TEXT, Arapça, emoji ve diğer Latin olmayan alfabeler için UNICODE). Başarılı bir çağrı, yanıt gövdesinde mesaj kimliği (message ID) ile birlikte 200 OK döner.
Kodlama ve uzunluk
Bir GSM-7 mesajı segment başına 160 karakter alır (mesaj birden fazla segmente yayıldığında 153 karakter); emoji veya Latin alfabesi dışındaki karakterler için Unicode'a geçildiğinde bu sayı 70'e (birleştirilmiş halde 67) düşer. Karakterlerin bozulmaması için düz GSM-7 için messageType değerini TEXT, metin gövdesi Unicode veya Arapça gerektirdiğinde ise UNICODE olarak ayarlayın — POST /sms/identify, göndermeden önce kodlamayı ve segment sayısını döndürür.
Teslimatı takip edin, varsaymayın
Döndürülen mesaj ID'si, teslimat makbuzları (DLR'ler) için tanımlayıcıdır. Gönderim anındaki 200 yanıtını mesajın telefona ulaştığının kanıtı olarak kabul etmek yerine, operatörün nihai durumunu — iletildi, başarısız veya süresi doldu — almak için bir webhook yapılandırın.
Canlıya geçiş
Uluslararası E.164 numaraları kullanın, ölçeklendirmeden önce her hedef pazarda gönderici adınızı kaydedin ve tutarlı gecikme süreleri için doğrudan operatör rotaları üzerinden gönderim yapın. Yüksek hacimli işlemler için aynı hesaba REST ile birlikte SMPP üzerinden de erişilebilir; böylece HTTP ile başlayabilir ve yeniden kayıt sürecine girmeden bağlantı türlerini değiştirebilirsiniz.