Webhook ile WebSocket arasındaki fark, bağlantıyı kimin açtığına indirgenir. Webhook, veri kaynağının sizin açtığınız bir adrese gönderdiği bir HTTP isteğidir. WebSocket ise sisteminizin açıp açık tuttuğu, mesaj almak için kullanılan bir bağlantıdır. Polling, belirli aralıklarla tekrar tekrar sormak anlamına gelir. Hangisini seçerseniz seçin, bir kesintinin ardından geride kalanları yakalamak için bir geçmiş okuması tutun.
Entegrasyon tarafından bakınca seçimin iki şeye bağlı olduğunu görüyorum: güvenlik duvarları ve alıcı taraf kapalıyken gelen olaylara ne olduğu.
Polling ile webhook arasındaki fark nedir?
Polling’de sisteminiz yeni veriyi bir zamanlamaya göre ister; webhook ile ise bir şey olduğunda kaynak sisteminizi çağırır. Polling basittir ve yalnızca dışa giden bağlantılar gerektirir, ancak boş her yanıt boşa harcanan bir iştir ve yeni veri en fazla bir aralık boyunca bekler.
Long polling ikisinin arasında yer alır. Sunucu her isteği açık tutar ve yalnızca iletilecek bir şey olduğunda yanıt verir. RFC 6202, zaman aşımlarının 120 saniyeye kadar çıkabildiğini ve başarılı olduğunu belirtir, ancak proxy’lerin daha uzun istekleri kesebileceği için 30 saniyeyi daha güvenli değer olarak önerir.
Webhook, göndericinin internetten erişebileceği bir uç nokta gerektirir; bu da sizin tarafınızda gelen trafiğe izin veren bir güvenlik duvarı kuralı anlamına gelir. Uç noktanız kapalıysa göndericinin yeniden denemelerine bağlı kalırsınız ve bunlar hizmetten hizmete farklılık gösterir.
Ne zaman WebSocket kullanmalısınız?
Tarafınızın bağlantıyı açmasını ve iki tarafın da konuşmasının gerekebileceği durumlarda WebSocket kullanın. RFC 6455, bir HTTP Upgrade isteği olarak başlayan ve 80 ve 443 portları üzerinden çalışacak şekilde tasarlanmış bir el sıkışma tanımlar; bundan sonra mesajlar iki yönlü akar. Ping ve Pong çerçeveleri bağlantıyı canlı tutmak için kullanılır.
Bağlantıyı alıcı açtığı için alıcı tarafta yeni bir gelen trafik güvenlik duvarı kuralı gerekmez. Soket kapalıyken, sunucu saklamadığı sürece mesajlar sizin için depolanmaz.
Sunucu gönderimli olaylar (SSE) ne zaman kullanılmalı?
Sunucu gönderimli olaylar (SSE), sunucudan istemciye düz HTTP üzerinden tek yönlü bir akış için uygundur. HTML belirtimi text/event-stream biçimini tanımlar; bağlantı koptuğunda tarayıcı yeniden bağlanır ve gördüğü son olay kimliğini Last-Event-ID başlığıyla gönderir, böylece sunucu kaldığı yerden devam edebilir.
Belirtim ayrıca, bazı eski proxy’lerin boşta kalan HTTP bağlantılarını düşürmesi nedeniyle yaklaşık her 15 saniyede bir yorum satırı gönderilmesini önerir. SSE’de istemcinin geri konuşabileceği bir kanal yoktur, bu yüzden komutlar ayrı isteklerle gönderilir.
| Ölçüt | Polling | Webhook | WebSocket | SSE |
|---|---|---|---|---|
| Bağlantıyı kim açar | Alıcı | Gönderici | Alıcı | Alıcı |
| Alıcıda gelen trafik güvenlik duvarı kuralı | Hayır | Evet | Hayır | Hayır |
| Yön | İstek ve yanıt | Göndericiden alıcıya | İki yönlü | Sunucudan istemciye |
| Alıcı kapalı | Bir sonraki sorgu alır | Gönderici yeniden dener, destekliyorsa | Kaçırılan mesajlar | Sunucu destekliyorsa son olay kimliğiyle devam edilir |
Veri kaybetmeden polling’den olaylara nasıl geçilir?
Güvenlik ağı olarak bir geçmiş okuması tutun ve üzerine itme kanalını ekleyin. Cihaz verileri zaman damgası taşır; bu yüzden boşluk, kaynak hâlâ tutuyorsa saklanmış okumalardan doldurulabilir.
- Bir imleç (cursor) saklayın: işlediğiniz son öğenin zaman damgası veya olay kimliği.
- İtme kanalını açın: bir webhook uç noktası, bir WebSocket veya bir SSE akışı.
- Başlangıçta ve her yeniden bağlanmadan sonra, kaynağın geçmiş API’si üzerinden imleçten şu ana kadar olan geçmişi okuyun.
- Geçmiş okuması ile itme işlemi çakışacağı için olay kimliğine veya cihaz ve zaman damgasına göre tekilleştirin.
- İmleci yalnızca öğe güvenle kaydedildikten sonra ilerletin.
Adım 4, webhook’lar için en çok önemli olandır. RFC 9110, PUT, DELETE ve güvenli metodları idempotent olarak listeler, POST’u ise listelemez; webhook’lar ise genellikle POST ile gelir. Bu nedenle tekrarlanan bir teslimat sizin tarafınızda zararsız olmalıdır. Aynı işleyicide geç ve yinelenen okumalar için plan yapın. Cihazlarınız hâlâ protokoller arasında seçim yapıyorsa, daha önce IoT cihazları için MQTT ve HTTP karşılaştırmasını yapmıştım.
Sıkça sorulan sorular
Webhook’lar genel bir IP adresi gerektirir mi?
Alıcının göndericinin erişebileceği bir adrese ihtiyacı vardır; bu genellikle herkese açık bir uç nokta ve gelen trafik güvenlik duvarı kuralı anlamına gelir. Buna izin verilmiyorsa, tarafınızın bağlantıyı açtığı bir model seçin: polling, bir WebSocket veya bir SSE akışı.
Cihaz verileri için ne sıklıkla polling yapmalıyım?
Verinin değiştiği ve kaynağın izin verdiği hızdan daha sık sorgulamayın. Sunucuyu aşırı yüklemeden daha düşük gecikme istiyorsanız, RFC 6202’nin önerdiği yaklaşık 30 saniyelik zaman aşımlı long polling bir ara çözümdür.
Bir webhook alıcısı için idempotent ne anlama gelir?
Aynı teslimatı iki kez işlemenin, bir kez işlemekle aynı etkiyi yapması demektir. RFC 9110 HTTP metodları için idempotentliği tanımlar ve POST idempotent metodlar arasında değildir; bu yüzden alıcı, örneğin her olay kimliğini saklayıp tekrarları yok sayarak kendini idempotent hale getirmelidir.

