Entegrasyon · 8 dk
API idempotency rehberi: Mükerrer siparişleri nasıl önlersiniz?
Timeout ve yeniden deneme sırasında aynı ticari işlemin iki kez oluşmasını engelleyen uygulama deseni.
Timeout ve yeniden deneme sırasında aynı ticari işlemin iki kez oluşmasını engelleyen uygulama deseni.
İstek ile ticari işlemi ayırın
İstemci yanıt alamadığında aynı isteği yeniden gönderebilir. Sunucu her isteği yeni işlem sayarsa mükerrer sipariş veya tahsilat oluşur. İstemcinin ürettiği idempotency anahtarı, aynı ticari niyeti güvenli biçimde tanımlar.
Sonucu anahtarla birlikte saklayın
Anahtar, istek özeti, işlem durumu ve üretilen yanıt atomik olarak kaydedilmelidir. Aynı anahtar farklı içerikle gelirse hata dönülmeli; işlem sürüyorsa istemciye mevcut durum bildirilmelidir.
- Anahtar kapsamı ve süresi
- İstek gövdesi özeti
- Atomik kayıt
- Aynı yanıtın tekrar sunulması
Asenkron akışta da koruyun
HTTP katmanındaki kontrol yeterli değildir. Kuyruk tüketicileri de mesaj kimliği veya iş anahtarıyla yinelenen teslimleri tanımalı; dış sistem çağrıları aynı koruma zincirine dahil edilmelidir.