Ana içeriğe geç

SMS API entegrasyonunda iletilmeyen mesajların güvenli yeniden işlenmesi

Çözümün özeti SMS servis çağrısının ağ hatası döndürmesi, mesajın kesinlikle gönderilmediği anlamına gelmeyebilir. Kör tekrar deneme aynı OTP veya işlemsel bildirimi iki kez göndererek kullanıcıyı şaşırtabilir. Çözüm, çağrı sonucu ile nihai teslimat olayını ayıran bir yeniden işleme modelidir.

Problemin kapsamı ve karar noktaları Yeniden denemenin sınırı mesajın amacına göre değişir. Son kullanma süresi dolmuş OTP yeniden gönderilmemeli; teslimat belirsizliği nedeniyle yeniden denenecek işlem mesajında ise aynı iş olayına ait tekil anahtar korunmalıdır. İşlemsel ileti güvenliği için uygulama olayı, SMS servis isteği ve nihai teslimat farklı kayıtlardır. Kullanıcı kimliği doğrulaması, ticari iletiye onay verildiği anlamına gelmez. OTP geçerlilik süresi, yanlış deneme sınırı, tekrar deneme ve hassas verilerin mesajda görünürlüğü birlikte düşünülmelidir. SMS kanalında operatör gecikmesi veya numaranın el değiştirmesi olabileceği için uygulama tek sinyale aşırı güvenmemeli, teknik istisnalar için güvenli yedek senaryolar tanımlanmalıdır.

Çalışmaya başlamadan önce

  • API yanıt kodları ve teslimat durumlarını dokümantasyondan eşleyin
  • Mesaj tiplerine geçerlilik ve tekrar deneme politikası atayın
  • İş olayı kimliği ile gönderim kimliğini ayrı saklayın
  • Kuyruk, alarm ve manuel müdahale yetkilerini belirleyin

Adım adım uygulama planı

AşamaYapılacak çalışma ve kontrol gerekçesi
1. HazırlıkSMS talebine benzersiz iş olayı kimliği ekleyin
2. TasarımBağlantı zaman aşımında otomatik tekrar yerine önce servis durumu sorgusunu değerlendirin
3. KontrolGeçici ve kalıcı hataları ayrıştıran kontrollü tekrar deneme zamanlaması belirleyin
4. UygulamaSüre dolmuş, ret alınmış veya yerine gelmiş iş olaylarını kuyruktan çıkarın
5. DoğrulamaTeslimat geri bildirimini gönderim kaydıyla eşleştirip durumu sonlandırın
6. İzlemeHata limiti aşılırsa insan müdahalesi ve alternatif kanal kararını devreye alın

Örnek uygulama senaryosu Bir bankacılık uygulaması işlem uyarısı gönderirken API isteğinde zaman aşımı alır. Ağ isteği servis tarafında işlenmiş olabilir. İşlemin tekil kimliği ve servis kayıtları karşılaştırılır; aynı uyarı ikinci kez körlemesine gönderilmez. OTP’de ise yeni talep eski kodu geçersiz kılabilir.

Canlıya alma ve olumsuz durum testleri

  • Aynı iş olayı için iki kez teslimat oluşmadığını sınayın
  • Gecikmeli teslimat yanıtının yanlış yeni mesaja bağlanmadığını doğrulayın
  • Kalıcı hata alan numaranın sonsuz tekrar döngüsüne girmediğini test edin

Bu olumsuz durumlar mümkünse canlı müşteri verisi kullanılmadan, test hesapları ve kayıtlı senaryolarla çalıştırılmalıdır. Sonuçta yalnız beklenen çıktının görünmesi değil, yanlış çıktının nasıl engellendiği de kanıtlanmalıdır. Her başarısız test için ilgili iş olayı, sistem kaydı ve düzeltme sorumlusu belirtilmelidir.

İzleme ve kabul göstergeleri

GöstergeNasıl değerlendirilmeli?
Mükerrer gönderim oranıMesaj amacı bazında
Belirsiz gönderim kuyruğu yaşıAlarm üretir
Başarılı teslimat için ortalama denemeMaliyet etkisini gösterir

Başlangıç değerleri pilot öncesinde ölçülmeli; hedefler örnek olay, işlem hacmi ve kurumun risk toleransına göre iş sahibi tarafından belirlenmelidir. Bir tek göstergeye bakarak başarı ilan etmek yerine kalite, hız, kullanıcı etkisi ve uygunsuz işlem sinyalleri birlikte değerlendirilmelidir.

Sık yapılan hatalar

  • HTTP hata kodunu her durumda gönderilmedi diye yorumlamak
  • OTP geçerlilik süresini yok sayarak tekrar etmek
  • Teslimat raporu olmadan başarıya kesin karar vermek

Sorumluluk paylaşımı

  • Ürün/uygulama: işlem tetikleyicisini ve kullanıcı akışını yönetir.
  • Güvenlik: doğrulama, sınırlama ve hassas veri kontrollerini onaylar.
  • Operasyon: gecikme, yeniden deneme ve hataları izler.

Sorumluluk tablosu yalnız iş unvanlarını sıralamamalı; onay veren, sistem değişikliğini yapan, sonucu denetleyen ve olay anında müdahale eden kişilerin ayrı olduğundan emin olunmalıdır. Karar değiştiğinde işlem kaydının tarih ve sürümü de güncellenmelidir.

Mobildev çözümleriyle bağlantı Mobildev SMS API ve SMS Marketing Suite gönderim/teslimat raporları, yeniden deneme ve durum eşleme tasarımına veri sağlayabilir. İdempotent iş olayı anahtarı, kuyruk ve geri dönüş kurallarının uygulama katmanında kurulması müşterinin entegrasyon mimarisine bağlıdır.

Sürdürülebilir işletim ve güncelleme Üretim logları, hizmetteki sorunu incelemeye yetecek kadar ayrıntı sunarken OTP değeri veya gereksiz müşteri verisi taşımamalıdır. Kullanıcıya gösterilen sonuç ve arka plandaki teslimat kaydı arasındaki fark düzenli kontrol edilmelidir. İlgili akış için ilk devreye alma sonrası belirli aralıklarla kayıt örneklemi alınmalı; yeni marka, kanal, şube, form, yazılım sürümü veya operasyon ekibi değişikliğinin kontrol tasarımını etkileyip etkilemediği yeniden değerlendirilmelidir. Sadece arayüzde görünen son duruma değil, kaynağına ve gerçekleşen teknik sonuca bakılmalıdır.

Kontrol ve karar kaydı “SMS API entegrasyonunda iletilmeyen mesajların güvenli yeniden işlenmesi” çalışmasının tamamlandı sayılması için altı uygulama aşamasının çıktıları, en az bir başarısızlık senaryosu ve mükerrer gönderim oranı göstergesinin başlangıç sonucu aynı karar dosyasında bulunmalıdır. Uygunluk, entegrasyon veya hizmet kapsamına ilişkin varsayımlar açıkça işaretlenmeli; hukuki değerlendirme gerektiren başlıklar ürünün teknik işlevleriyle karıştırılmamalıdır.

Ürün ve teknik kaynaklar Mobildev – ilgili ürün / teknik kaynak