API timeout sonrası tekrar deneme: aynı isteği iki kez işlememek
İstemci zaman aşımı aldığında sunucunun işlemi hiç yapmadığı kesin değildir. Yanıt ağda kaybolmuş olabilir; kullanıcı yeniden gönderdiğinde iş mantığının aynı kaydı ikinci kez oluşturmaması gerekir. Idempotency, aynı işlemin tekrar edilmesinin iş sonucunu bozmasını engelleyen davranışı ifade eder.
Arşiv incelemesi · Konu yılı 2020
Dönemin sorusu ve iş ihtiyacı
İstemci zaman aşımı aldığında sunucunun işlemi hiç yapmadığı kesin değildir. Yanıt ağda kaybolmuş olabilir; kullanıcı yeniden gönderdiğinde iş mantığının aynı kaydı ikinci kez oluşturmaması gerekir. ödeme ya da rezervasyon oluşturma içinde bu yaklaşımın değerini anlamak için hızlı bir gösteriden ziyade hedeflenen kullanıcı görevine bakmak gerekir. Kaynak sistemler, veri biçimleri ve hata payı bilinmeden araç seçmek maliyeti gizler. Konu yılı bir teknoloji perspektifidir; yazının gerçek yayımlanma tarihi değildir. Geçmişin doğru fikrini güncel kullanımdan ayırmak tasarımı sadeleştirir.
Teknik davranış ve sorumluluk sınırı
Idempotency, aynı işlemin tekrar edilmesinin iş sonucunu bozmasını engelleyen davranışı ifade eder. HTTP yöntemlerinin tanımlı idempotent semantiği ile iş düzeyinde idempotency anahtarı çözümünü birbirinden ayırmak gerekir. Mekanizmayı değerlendirirken giriş, işlem ve sonuç birbirinden ayrılmalıdır. ödeme ya da rezervasyon oluşturma için istemcinin aldığı başarılı yanıt, bağlı verinin doğruluğunu kendi başına kanıtlamaz. Sürümün izin verdiği işlem, kontrolün hangi katmanda uygulandığı ve kalıcı kayıt gereksinimi ayrı ayrı belgelenmelidir. Böylece yeni geliştirici yalnız çalışan kodu değil, davranışın nedenini de anlayabilir.
Uygulamada veri akışının kurulması
Ödeme oluşturma isteğine tekil işlem anahtarı eklemek tekrar gönderimde önceki sonucun bulunmasını sağlayabilir. Anahtarın kullanıcı, işlem içeriği ve belirli saklama süresiyle ilişkilendirilmesi gerekir. Bir veri akışı yalnız mutlu yolun peş peşe çalışmasından oluşmaz. ödeme ya da rezervasyon oluşturma içinde kayıt kimliği, tarih alanı, tekrar deneme ve güncelleme önceliği de sözleşmeye dahildir. Beklenmeyen yanıtı sessizce kabul etmek yerine kaynağı doğrulayın; sonucun yalnız ekranda değil kalıcı kayıt üzerinde de tutarlı olduğunu ölçün.
Beklenmeyen durumlar ve riskler
Anahtar çakışması durumunda farklı tutardaki ödeme aynı kayda bağlanmamalıdır. Paralel iki isteğin aynı anda ulaşması da yarış koşulu doğurur; yalnız uygulama belleğindeki Set yapısı kalıcı güvence değildir. Yanlış sonuç her zaman hata mesajı üretmez. ödeme ya da rezervasyon oluşturma gibi bir süreçte eksik satır, yinelenen kayıt, eski önbellek veya yetkisiz erişim ayrı hata türleri oluşturur. Hangi türün oluştuğunu ölçebilecek izleme olmadan yalnız yeniden deneme sayısını artırmak kök nedeni gizleyebilir. Belirsiz işlemlerde güvenli duruş davranışı önceden tanımlanmalıdır.
Test sonuçlarını nasıl yorumlamalı?
Aynı anahtarla art arda istek, eşzamanlı istek, yanıt kaybı ve farklı içerikle yeniden gönderim testleri kurun. Başarı ölçütü 200 yanıtı sayısı değil, tekil işlem kaydı ve tutarlı kullanıcının gördüğü sonuçtur. Gerçekçi test olumlu örnek kadar olumsuz örneği de içerir. ödeme ya da rezervasyon oluşturma için boş sonuç, yanlış veri türü, bağlantı kesilmesi ve yetkisiz isteklerin etkisini gözleyin. Yalnız ortalama hız yerine yüksek gecikme, kaynak tüketimi ve yanlış iş sonucu oranını da kaydedin. Her sayı hangi koşulda ölçüldüğüyle birlikte sunulmalıdır.
Bugüne kalan mimari ders
Ağda güvenilirlik sağlamak için isteğin kimliği sunucuda saklanmalıdır. Retry mekanizması hem kullanıcıyı korur hem operasyon maliyetini azaltır; ancak doğru kayıt anahtarı ve tutarlılık koşulu olmadan tekrarı daha hızlı üretir. ödeme ya da rezervasyon oluşturma için doğru araç seçimi hız, doğruluk, güvenlik, bakım ve geri dönüş maliyetinin birlikte değerlendirilmesini gerektirir. Yeni sürüm bu dengeyi değiştirdiğinde karar yeniden incelenebilir. Tarihsel bir fikrin değerini abartmadan, ölçülebilir yararı ve sınırlarını açıkça belirtmek geliştirici için daha kullanışlıdır.
Yorumlar
Henüz yorum yok. İlk katkıyı sen yapabilirsin.
Yorum yaz
Yazı üzerine görüşler
Editör tarafından hazırlanmış tartışma örnekleri.
“API timeout sonrası tekrar deneme: aynı isteği iki kez işlememek” üzerine tartışsak önce kullanıcı tarafındaki başarısızlık durumlarının sınanması sorusunu sorardım. Farklı bir değerlendirme yapan var mı?
Sorunun merkezinde şu konu var: kullanıcı tarafındaki başarısızlık durumlarının sınanması. Gözlemi varsayımdan ayıran ölçümler netleşmeden kesin sonuç çıkarmamak gerekir.
“API timeout sonrası tekrar deneme: aynı isteği iki kez işlememek” başlığında en fazla sürüm geçişinde geriye uyumluluğun korunması hakkında somut örnek merak ettim. Farklı bir ortamda aynı değerlendirme geçerli olur mu?
Olumlu yönleri anlıyorum ama bakım yükü ile teslim hızının dengelenmesi bakımından beklenmedik maliyetler olabilir. Deneyimden önce kontrol listesi oluşturmak mantıklı.
Bu fikri bir ekip toplantısına taşısam ilk soracağım şey API sözleşmesinin sürümler arasında korunması olur. Hangi varsayımı değiştirdiğimizde karar da değişir?
Yerinde bir itiraz; API sözleşmesinin sürümler arasında korunması açısından farklı ortamlardan veri olmadan genelleme yapmamak gerekir.
Bu başlıkta beni düşündüren hata ayıklamada tekrarlanabilir test kurulması. Tek bir örnek yerine aykırı sonuçları da gösteren bir karşılaştırma daha ikna edici olur.
“API timeout sonrası tekrar deneme: aynı isteği iki kez işlememek” ile ilgili önceki çalışmalarla kıyas yapılabilse iyi olur. Özellikle izleme ve kayıtların kök nedeni göstermesi açısından yöntem ve veri aynı mı, görmek isterim.