Webhook Entegrasyonları

Nasıl Çalışır?

• •Olay olur → KolayStartup uç noktanıza POST gönderir
• •Uç noktanız 2xx döndürürse teslim başarılı sayılır
• •2xx dışı yanıt veya zaman aşımında yeniden deneme yapılır

Örnek Olay Türleri

• •application.created — Yeni başvuru oluşturuldu
• •application.status_changed — Başvuru durumu değişti
• •match.created — Yeni eşleşme bulundu
• •message.received — Yeni mesaj alındı
• •payment.succeeded — Ödeme başarıyla tamamlandı

Örnek Payload

{
  "id": "evt_1a2b3c",
  "type": "application.status_changed",
  "created_at": "2026-06-02T09:30:00Z",
  "data": {
    "application_id": "app_789",
    "from": "pending",
    "to": "approved"
  }
}

İmza Doğrulama

import crypto from 'crypto';

function verify(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected),
  );
}

Yeniden Deneme ve İdempotans

• •Hızlı yanıt verin (ağır işi kuyruğa alın, hemen 2xx dönün)
• •Olay "id"'sini saklayıp tekrarları yok sayın
• •Uç noktanızı yalnızca HTTPS üzerinden yayınlayın