FDE Foundations · Modül 5: Veri ve Entegrasyon
Webhook'lar ve Olay Alımı
Webhook alım kuralı: doğrula, hızlı onayla, sonra işle. Gerisi (yeniden deneme, dedup, replay) teslimi en az bir kez olarak görmekten çıkar.
11 dk okuma
Kazanımlar
- Webhook'ları doğrulayarak ve hızlı 2xx onayıyla almak
- Dayanıklı kuyruktan asenkron işlemek
- En az bir kez teslim için replay ve tekilleştirme tasarlamak
Güvenli al
Her teslimde yüke güvenmeden imzayı doğrula (sağlayıcının şemasına göre paylaşılan gizli anahtarla HMAC). Gerçek işi yapmadan önce hızlıca 2xx ile onayla; yavaş işleyiciler sağlayıcı tarafında zaman aşımı üretir, zaman aşımı kopya teslim üretir, kopya teslim senin kopya problemini üretir.
Asenkron işle
Olayı kuyruğa al ve dön. Bir işçi kuyruğu m04'teki idempotency ve yeniden deneme desenleriyle işler: hataları sınıflandır, geri çekil, kalıcıları ölü mektuba yaz. Bu ayrım alımı kendi dağıtımlarına ve aşağı akış kesintilerine dirençli kılar.
En az bir kez demek dedup demek
Sağlayıcılar en az bir kez teslim eder. Olay kimliğiyle tekilleştir; ama bellek içi setle değil depo destekli kontrolle: dedup'un anlamı yeniden başlamalarda hayatta kalmaktır. Kopya teslimleri debug düzeyinde kaydet; dedup'un çalıştığını kanıtlayabil.
Replay bir gerekliliktir
İlk günden replay yolu tasarla: zaman aralığı ya da ölü mektup grubu seç, olayları aynı idempotent hat üzerinden yeniden sür. Yukarı akış hatası ya da kötü dağıtımın bir gün veriyi bozduğunda replay, bir saatlik iş ile bir haftalık özür arasındaki farktır.
Mini kontrol
2-3 soruluk isteğe bağlı öz kontrol. Yanıtlar cihazından çıkmaz, saklanmaz ve hiçbir değerlendirmeye sayılmaz.
Alıştırma
Bir ödeme sağlayıcı için kurgusal webhook alıcısı tasarlayın: imza doğrulama adımı, onay davranışı, kuyruk-işçi ayrımı, dedup anahtarı ve bozuk 6 saatlik pencere için replay prosedürü.
Geçme kriterleri
Doğrulama mekanizmasıyla adlandırılmış, işlemenden önce onay, işçili dayanıklı kuyruk, depolu olay kimliği dedup'u ve işlem idempotent olduğu için güvenli bir replay prosedürü bulunmalıdır.