Ana içeriğe geç
Edivcode YazılımYAZILIM · ÇÖZÜM · GELECEK

API isteğinin yanıt vermemesi, işlemin karşı sistemde yapılmadığı anlamına gelmez. Bu nedenle tekrar deneme tasarımı, geçici hatayı gidermenin yanında aynı siparişin veya kaydın iki kez oluşmasını da önlemelidir. Idempotency, aynı işlemin yeniden istenmesiyle ek yan etki üretilmemesini sağlayan tasarım yaklaşımıdır.

Zaman aşımını başarısız işlemle karıştırmayın

Varsayımsal örnek: Mağaza, kargo sistemine gönderi oluşturma isteği gönderiyor. Kargo kaydı oluşuyor ancak yanıt ağda kayboluyor. Mağaza hiçbir kontrol yapmadan tekrar istek gönderirse ikinci bir gönderi kaydı oluşabilir. Bu durumda “yanıt alınamadı” ile “gönderi oluşturulmadı” ayrı durumlar olarak ele alınmalıdır.

Karşı API destekliyorsa işleme ait benzersiz bir anahtar kullanılır. Aynı iş için tekrar denemede aynı anahtar korunur; her denemede yenisini üretmek korumayı bozar. Destek yoksa uygulamanın kendi işlem kaydı, karşı sistemdeki referans ve durum sorgulama imkanları birlikte değerlendirilmelidir. Eşzamanlı iki isteğin aynı kaydı oluşturmaması için veritabanı düzeyindeki benzersizlik ve işlem sınırları da önemlidir.

Hangi hatanın yeniden denenebileceğini belirleyin

  • Geçersiz alan veya yetki hatasını aynı veriyle sürekli tekrar göndermeyin.
  • Geçici ağ ve sunucu hataları için API sözleşmesine uygun sınırlı deneme planlayın.
  • Varsa Retry-After yanıtını ve sağlayıcının işlem kotasını dikkate alın.
  • Denemeler arasına artan bekleme ve uygun rastgelelik ekleyerek eşzamanlı yükü sınırlayın.

HTTP yöntemlerinin anlamı ile uygulamanın iş davranışı birlikte incelenmelidir. Bir uç noktanın POST kullanması tek başına güvenli tekrar deneme sağlamaz. MDN idempotent açıklaması ve Retry-After belgesi temel kavramları açıklar; gerçek davranış için sağlayıcının güncel sözleşmesi esas alınır.

Operasyon ekibinin görebileceği durumlar üretin

İşlem için bekliyor, işleniyor, tamamlandı ve inceleme gerekiyor gibi açık durumlar belirlenebilir. Sonsuz tekrar yerine sınır aşılınca bildirim ve kontrollü yeniden çalıştırma gerekir. Günlüklerde işlem kimliği, deneme sayısı ve güvenli hata özeti bulunabilir; erişim anahtarı, kart veya kişisel veri kaydedilmemelidir.

Testte yalnızca başarılı yanıtı denemeyin. Yanıt kaybı, gecikme, çift bildirim, sıra dışı geliş ve eşzamanlı istek senaryolarını da kontrol edin. Başarılı iş kaydının tekrar gönderildiğinde değişmediği doğrulanmalıdır. Mevcut veri akışınızı ve hata durumlarını API ve sistem entegrasyonu çalışmasında bu kontrol noktalarıyla değerlendirebilirsiniz.

← Tüm Blog Yazıları

Projenizi konuşalım.

İhtiyacınızı paylaşın; kapsamı ve sonraki adımı birlikte belirleyelim.

Birlikte konuşalım