Uygulamama bir API ile SMS gönderimini nasıl eklerim?

Entegrasyon adımları

1. Test kimlik bilgilerini alın ve göndereceğiniz test numaralarını kaydettirin.
2. API anahtarını sunucunuzda bir gizli bilgi yöneticisinde veya ortam değişkeninde saklayın; mobil uygulamada ya da tarayıcı kodunda asla tutmayın.
3. Numaraları E.164 biçiminde saklayın ve API'nin beklediği biçime dönüştürün.
4. Kodlamayı seçin: GSM-7 metin veya Arapça, emoji ve diğer yazı sistemleri için Unicode.
5. Mesajı gönderin ve dönen mesaj kimliğini kendi kaydınızın yanında saklayın.
6. İletim durumlarını almak için bir webhook kurun.
7. 429 ve 5xx yanıtları için geri çekilmeli (backoff) yeniden denemeler ekleyin ve gerektiren her ülke için SMS başlıklarını kaydettirin.

Kaçınılacak hatalar

• API'yi istemci uygulamasından çağırmak; bu, anahtarı herkese açık hale getirir.
• API yalnızca rakam beklerken numaraları artı işareti, boşluk veya ulusal baştaki sıfırla göndermek.
• Tek bir kıvrık tırnağın veya emojinin mesajın tamamını Unicode'a çevirmesine izin vermek; bu, parça başına karakter sayısını düşürür.
• Zaman aşımından sonra körü körüne yeniden denemek. API'de idempotency anahtarı yoksa her gönderimi önce kaydedin ve yeniden göndermeden önce durumunu kontrol edin.
• 429 yanıtlarını yok sayıp Retry-After başlığını beklememek.

Örnek: tek bir SMS isteği

OmniChannels.ai'da tek bir SMS'i POST https://api.broadnet.me/sms/sendSms ile, bir Authorization: Bearer başlığı ve JSON gövdesiyle gönderirsiniz. Başarılı çağrı, mesaj kimliğini düz metin olarak içeren 200 yanıtı döndürür. Test erişimi kısa bir talebin ardından verilir ve yalnızca doğruladığınız kendi numaralarınıza gönderim yapar; anında self servis kayıt yoktur.

Resmî kaynaklar

• RFC 9110: HTTP Semantics (IETF)
• ITU-T Recommendation E.164 — The international public telecommunication numbering plan
• 3GPP TS 23.038 — Alphabets and language-specific information