Webhook Nedir ve Neden Kullanılır?

Webhook, bir sistemde olay gerçekleştiğinde hedef URL'e HTTP POST isteği atan mimaridir. Ters API (Reverse API) olarak çalışır. Polling yöntemindeki gibi sürekli sorgu atılmaz; kaynak tüketimi düşer, veri iletimi anlık gerçekleşir.

Geleneksel polling sunucu yükünü artırır. Webhook ise olay güdümlü (event-driven) mimariyle modern web sistemlerinde performansı maksimize eder.

Webhook Mimarisi Temel Bileşenleri

Event Provider (Sağlayıcı): Olayı tetikleyen servis (Stripe, GitHub, CRM vb.).
Payload: Olay detayını içeren JSON verisi.
Webhook Listener (Tüketici): İsteği karşılayan API endpoint.
Retry & Queue Sistemi: Hatalı istekleri yeniden deneme mekanizması.

Adım Adım Webhook Entegrasyonu Kurulumu

Adım 1: Güvenli Endpoint Oluşturma

Tüketici sunucuda yalnızca POST isteklerini kabul eden endpoint tanımlanır. Payload JSON formatında okunur. İşlem öncesi HTTP 200/202 dönülerek sağlayıcının zaman aşımına (timeout) uğraması engellenir.

Adım 2: Güvenlik ve HMAC İmza Doğrulama

Gelen isteğin doğruluğu HMAC SHA256 imzası ile kontrol edilir. Sağlayıcı ile paylaşılan gizli anahtar (secret key) kullanılır. Sahte istekler anında reddedilir.

Header içindeki X-Signature veya Stripe-Signature değeri okunur.
Ham body verisi gizli anahtarla hash'lenir.
Üretilen hash ile header hash'i zamanlama saldırılarına (timing attack) dayanıklı fonksiyonla karşılaştırılır.

Adım 3: Idempotency (Tekilleştirme) Uygulama

Ağ kopmalarında sağlayıcılar aynı isteği tekrar gönderir. Sistemde mükerrer işlem oluşmaması için her olayın tekil kimliği (event_id) veritabanında veya önbellekte (Redis) saklanır. İşlenmiş ID içeren istekler yoksayılır.

Adım 4: Arka Plan Kuyruğu (Queue Worker)

Ağır veri işleme süreçleri doğrudan HTTP yanıt döngüsünde yapılmaz. Payload kuyruk mekanizmasına (RabbitMQ, Redis Queue) aktarılır, tüketici hemen HTTP 200 döner. İşlem kuyruk işçisi tarafından asenkron tamamlanır.

Dijital Ajans ve Modern Web Projeleri İçin Trendler

Modern dijital ajans iş süreçlerinde webhook entegrasyonları ödeme sistemleri, headless CMS içerik güncellemeleri ve pazarlama otomasyonlarını birleştirir. Mikroservis ekosisteminde olay güdümlü iletişim standardıdır.

Serverless Tüketiciler: AWS Lambda veya Cloudflare Workers ile maliyetsiz webhook yakalama trendi.
Otomatik İzleme: Başarısız webhook çağrılarını izlemek için DLQ (Dead Letter Queue) kullanımı.
API Gateway Dağıtımı: İstek trafiğini dengelemek ve anlık yük patlamalarını önlemek.