GÜNDEMDE

DÜNYADAN TEKNOLOJİ HABERLERİ

→
Yazılım2020

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

Yazılımcının GünlüğüYayımlanma: 22 Kas 20264 dk okuma
Okuma ilerlemesi0%

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.

Servis mimarisiKavramsal şema · makalenin teknik akışını özetler

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.

İlk okuyan sen ol ✎ Yorum yaz

Yorumlar

Henüz yorum yok. İlk katkıyı sen yapabilirsin.

Yorum yaz

Adın ve soyadın yorumunla birlikte herkese açık görünecek.

Yazı üzerine görüşler

Editör tarafından hazırlanmış tartışma örnekleri.

Emir Doğan

“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ı?

Editörün değerlendirmesi

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.

Gökçe Korkmaz

“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?

Levent Tekin

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ı.

Ozan Arslan

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?

Editörün değerlendirmesi

Yerinde bir itiraz; API sözleşmesinin sürümler arasında korunması açısından farklı ortamlardan veri olmadan genelleme yapmamak gerekir.

Tuğçe Demir

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.

Alara Kara

“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.