← Blog
20 Kasım 2026· otomatik üretildi

Webhook'larla Sistemleri Birbirine Bağlamak

Webhook'lar nedir, nasıl çalışır ve sistemlerinizi birbirine bağlarken neden bu kadar güçlü bir araçtır? Pratik örneklerle açıklıyoruz.

#webhook#entegrasyon#sistem mimarisi#API

Birden fazla sistem kullanıyorsunuz ve bunların birbiriyle konuşmasını istiyorsunuz. Klasik çözüm: her birkaç saniyede bir "bir şey değişti mi?" diye sormak — buna polling diyoruz. Ama daha zarif, daha verimli bir yol var: Webhook'lar.

Webhook Nedir?

Webhook, bir sistemin belirli bir olay gerçekleştiğinde başka bir sistemi otomatik olarak haberdar etmesidir. "Olay odaklı (event-driven)" mimarinin en sade uygulamalarından biridir.

Şöyle düşünün: Polling, kapıya gidip her dakika "paket geldi mi?" diye sormaktır. Webhook ise kapıya oturup zil sesini beklemektir. Paket geldiğinde zil çalar, siz de harekete geçersiniz.

Teknik olarak bir webhook, bir HTTP POST isteğidir. Kaynak sistem, olayı tetiklendiğinde hedef sistemin belirlediği bir URL'e JSON (ya da XML) formatında veri gönderir.

Nasıl Çalışır?

Temel akış şu şekilde işler:

1. Hedef sistem bir URL tanımlar ve bu adresi kaynak sisteme bildirir. 2. Kaynak sistem, ilgili bir olay gerçekleştiğinde (ör. yeni sipariş, ödeme onayı, kod push'u) bu URL'e HTTP POST atar. 3. Hedef sistem gelen veriyi işler ve genellikle 200 OK döner. 4. Kaynak sistem 200 OK görmezse isteği yeniden deneyebilir.

Bu kadar. Karmaşık bir altyapı gerekmez; sadece bir endpoint ve biraz iş mantığı yeterlidir.

Gerçek Hayattan Kullanım Örnekleri

Webhook'ların ne kadar yaygın olduğunu fark etmek için etrafınıza bakmanız yeterli:

  • GitHub / GitLab: Bir branch'e kod push'landığında CI/CD pipeline'ı tetiklemek.
  • Stripe / İyzico: Ödeme tamamlandığında sipariş sistemini güncellemek.
  • Shopify: Yeni sipariş oluştuğunda ERP'ye stok düşmek.
  • Slack: Üretim ortamında hata oluştuğunda ilgili kanala mesaj atmak.
  • Jira: Bir ticket kapatıldığında proje yöneticisine e-posta göndermek.

Neredeyse her modern SaaS ürünü webhook desteği sunuyor. Bu durum, entegrasyonları inanılmaz ölçüde kolaylaştırıyor.

Dikkat Edilmesi Gereken Noktalar

Webhook'lar güçlüdür ama birkaç kritik noktayı gözden kaçırmamak gerekir:

  • Güvenlik: Gelen isteğin gerçekten beklenen kaynaktan geldiğini doğrulayın. Çoğu servis, payload ile birlikte bir HMAC imzası gönderir. Bunu mutlaka kontrol edin.
  • Idempotency (Tekrar işleme güvenliği): Aynı webhook birden fazla kez gelebilir. Sisteminizin bunu sorunsuz kaldırabildiğinden emin olun; her gelişinde yeni bir sipariş oluşturmayın.
  • Hata yönetimi: Endpoint'iniz meşgulse ya da geçici olarak çökerse ne olur? Kuyruk (queue) mekanizmalarıyla (RabbitMQ, Redis, SQS vb.) gelen webhook'ları dayanıklı hale getirebilirsiniz.
  • Loglama: Gelen her isteği loglayın. Hata ayıklarken bu loglar hayat kurtarır.
  • Zaman aşımı: Webhook handler'ınız hızlı yanıt vermeli. İş mantığını asenkron olarak arka planda işleyin, hemen 200 dönün.

Webhook mu, API Polling mu?

| Özellik | Polling | Webhook | |---|---|---| | Gecikme | Yüksek | Neredeyse sıfır | | Kaynak tüketimi | Yüksek | Düşük | | Karmaşıklık | Basit | Orta | | Gerçek zamanlılık | Zayıf | Güçlü |

Yoğun iş yükü olan sistemlerde polling ciddi bir overhead yaratır. Webhook'lar bu yükü ortadan kaldırır.

Son Söz

Webhook'lar, modern entegrasyon dünyasının sessiz kahramanlarıdır. Doğru kurulduğunda, birbirinden bağımsız sistemleri neredeyse sihirli bir şekilde birbirine bağlarlar. Küçük bir endpoint, büyük bir otomasyon kapısı açabilir.

Bir sonraki entegrasyon ihtiyacınızda önce kendinize sorun: "Bunu webhook ile çözebilir miyim?" Cevap çoğunlukla evet olacaktır.