Webhook ve olaylar
Yakında. Webhook teslimatı henüz yayında değildir. Bu sayfa, kararlaştırılmış ilkeleri özetler; ayrıntılar teslimat hazır olduğunda eklenecektir.
Kararlaştırılanlar
Webhook'lar, olayların güvenilir teslimi için kullanılan iç mesaj kuyruğu (outbox) üzerinden gönderilir.
Her istek HMAC-SHA256 imzası ve zaman damgası taşır; alıcı tarafın imzayı ve zaman damgasını doğrulaması beklenir.
Teslimat başarısız olursa yeniden deneme yapılır; sonunda teslim edilemeyen olaylar bir dead-letter kuyruğuna alınır.
Hedef adresler dış istek güvenliği (SSRF) korumasından geçer; her adrese çağrı yapılamayabilir.
Olay adı ve sürümü dış sözleşmedir. Olayın şeması değişirse olayın yeni sürümü yayımlanır; eski sürüm sürümleme politikasına göre desteklenir.
Olay adları ve yük alanları İngilizce olacaktır.
Olay zarfı; olayın türünü, sürümünü, ilgili kaydın türünü ve kimliğini, varsa şirket bilgisini ve olayı başlatan öznenin (kullanıcı veya istemci) bilgisini ve bir korelasyon kimliğini taşır. Aynı kayda ait olaylar sıralı işlenir.
Kendi başlattığınız bir değişikliğin olayı size geri gönderilmeyebilir (yankı döngüsünü önlemek için kanal adaptörlerinde uygulanır).
Aynı olay birden fazla kez teslim edilebilir; alıcınız olay kimliğine göre tekrarı yok saymalıdır (idempotent işleme).
Henüz belli olmayanlar
Toplu veri (şimdiden)
Webhook'a ek olarak Excel/CSV içe ve dışa aktarım şablonları planlanmıştır. Sütun anahtarları sabit, dilden bağımsız ve İngilizcedir; para ve miktarlar sabit ölçekli metin, tarihler ISO 8601'dir.