Webhook'lar

Webhook'lar, sürekli sorgulama gerektirmeden teklif, sipariş ve iş akışı olaylarını sistemlerinize iletir.

---

Teslimat temelleri

• Yalnızca HTTPS
• İmzalı istekler
• Zaman aşımı veya 2xx olmayan yanıt durumunda yeniden deneme
• İdempotent tüketici tasarımı önerilir

---

Olay aileleri

Olay ailesi	Örnek olaylar
Teklif yaşam döngüsü	quote.received, quote.updated
Sipariş yaşam döngüsü	order.created, order.confirmed, order.shipped
İş akışı sinyalleri	İş ortağına özel operasyonel olaylar

Kesin olay seti yetkilendirme ve kullanıma sunma durumuna bağlıdır.

---

Örnek yük yapısı

{
  "id": "evt_01js3q7d9w4b2k8m1z0h3v6x7y",
  "event": "quote.received",
  "timestamp": "2026-04-16T10:00:00.000Z",
  "data": {
    "rfqId": "rfq_123456",
    "quoteId": "quote_987654"
  }
}

---

İmza doğrulama

import crypto from 'node:crypto';

export function verifyWebhookSignature(rawBody: string, signature: string, secret: string) {
  const digest = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
  return signature === `sha256=${digest}`;
}

JSON ayrıştırma veya iş mantığından önce ham gövdeyi doğrulayın.

---

Tüketici rehberi

• Doğrulamadan sonra hızlıca 2xx döndürün ve ağır işleri kuyruğa alın
• İşlemeyi idempotent tutmak için teslimat kimliklerini saklayın
• İstek kimliklerini ve olay kimliklerini loglayın
• Webhook gizli anahtarlarını düzenli aralıklarla rotasyona alın

---

İlgili dokümanlar