İdempotency anahtarı
İdempotency anahtarı, aynı isteğe ait yeniden denemeleri tanımlar. Etkisini kapsam, saklama süresi ve API kuralları belirler.
İdempotency anahtarı, istemcinin seçtiği bir kimliktir; hizmet, aynı isteğe ait yeniden denemeleri bu kimlikle tanıyabilir. Amaç, zaten gerçekleştirilmiş bir iş eylemini yeniden denemede tekrar gerçekleştirmemektir. API sözleşmesi bunun nasıl işleyeceğini belirler.
Sonucu belirsiz bir isteği yeniden değerlendirin
Varsayımsal bir portalda sipariş oluşturma isteğinden sonra bağlantı kopar. ERP'nin siparişi oluşturup oluşturmadığı belirsizdir. Hizmet bu korumayı destekliyorsa portal, uygun yeniden denemede aynı anahtarı kullanır. Yeni bir anahtar, bir sipariş daha oluşturulmasına yol açabilir.
API kurallarını dikkate alın
Stripe, API v1 ve v2 için farklı idempotency kuralları açıklar. Idempotency-Key başlığı, belirli bir sağlayıcıya ait örnektir. Kapsamı, saklama süresini ve istek verileri değiştiğinde ne yapılacağını inceleyin. Aynı anahtar, her türlü yeni içeriğe izin vermez ve tek başına işlemenin tamamlandığını kanıtlamaz.
Kaynaklar
İlgili terimler
- Olay kimliğiOlay kimliği, üzerinde anlaşılmış kapsam içinde bir olayı tanımlar. Yeniden teslim ile yeni bir olayı birbirinden ayırmak gerekir.
- Webhook tekrar gönderimiWebhook tekrar gönderimi, bir bildirimin yeniden iletilmesidir. Eksik işlemi tamamlama ve tekrarlama saldırısı için farklı kontroller gerekir.
- Transactional InboxTransactional inbox, tekrar teslim edilen mesajların yerel işlemi yinelemesini önlemek için kalıcı mesaj kayıtları kullanır.
- Mesaj onayıMesaj onayı, bir teslimatın belirlenen kurala göre alındığını veya işlendiğini mesaj aracısına bildirir.
- Yeniden denemede rastgele gecikmeRetry jitter, bekleme sürelerini rastgele değiştirerek birçok istemcinin aynı anda yeniden istek göndermesini azaltır.
- Test kiracısıKiracılı uygulamada denetimler için kurulmuş, mantıksal olarak ayrılmış müşteri alanı.
Bu konudaki yazılar
ASES ile API ve entegrasyon
ERP, CRM ve mağaza sorunsuz bağlantılı