GÜNDEMDE

DÜNYADAN TEKNOLOJİ HABERLERİ

→
Web API'de idempotency key: aynı isteği iki kez kaydetmeden işlemek
Yazılım · 2015
Yazılım2015

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

Yazılımcının GünlüğüYayımlanma: 16 Kas 20263 dk okuma

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.

0 okunma

Yorumlar

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

✎ Yorum yaz

Yorumun gönderildiğinde görünür; spam ve tekrarlı gönderimler engellenir.