Web API'de idempotency key: aynı isteği iki kez kaydetmeden işlemek
Ağ tekrar denemesi ikinci ödeme veya ikinci siparişe dönüşmemeli. İstek kimliği, gövde özeti ve atomik kayıt birlikte tasarlanmalı.
Sorunun kaynağı ağ belirsizliği
Kullanıcı ödeme isteğini gönderir, sunucu işlemi kaydeder; fakat yanıt ağda kaybolur. İstemci tekrar denerse aynı sipariş iki kere işlenebilir. HTTP durum kodunu görmemek işlemin gerçekleşmediği anlamına gelmez. Özellikle POST gibi yan etki oluşturan çağrılarda istemcinin gönderdiği benzersiz istek kimliğini sunucu tarafında saklamak gerekir.
Anahtar, gövde özeti ve atomik yazma
Örneğin POST /orders isteğinde Idempotency-Key başlığı kullanın. Veritabanında kullanıcı kimliği, anahtar, normalize edilmiş istek gövdesinin özeti ve sonuç durumu için benzersiz kayıt oluşturun. Aynı anahtar ve aynı içerik yeniden gelirse önceki sonucu döndürün; aynı anahtar farklı içerikle gelirse açık bir çakışma yanıtı verin. Kontrol ve iş kaydı atomik olmalıdır.
POST /orders
Idempotency-Key: 47a03d19-8b5d-4abd-8107-92d36b7db510
Content-Type: application/json
{"productId":42,"quantity":1}Yarış koşulu ve süre sınırı
İki istek eşzamanlı gelebileceği için yalnız SELECT ile önce kontrol etmek yeterli değildir. Veritabanı benzersiz kısıtı, transaction ve eşzamanlılık testi gereklidir. Anahtarları sınırsız saklamak yerine işlem türüne uygun açık bir saklama süresi belirleyin. Saklama süresi bittikten sonra yinelenen isteğin yeniden işlenebileceğini sözleşmede belirtin.
Dönem notu ve test senaryosu
Bu açıklama 2015 çevresindeki Web API güvenilirlik sorunlarına bugünden bakar; o tarihte yazılmış olduğu iddia edilmez. Yanıt kaybı, eşzamanlı iki istek ve aynı anahtar–farklı gövde durumlarını ayrı test edin. Kullanıcıların anahtarlarını birbirine karıştırmayın; anahtarın kapsamını hesap ve işlem sınırlarıyla bağlayın. Başarı sayısını yalnız HTTP 200/201 kayıtlarından değil, tekil sipariş verisinden doğrulayın.
Yorumlar
Henüz yorum yok. İlk katkıyı sen yapabilirsin.
✎ Yorum yaz