Webhook ne zaman doğru seçim?
Sürekli izleme gerektirmeyen ama belirli bir eşikte harekete geçmesi gereken senaryolar için idealdir. Örneğin gram altın belirli seviyeyi aştığında pazaryeri fiyatlarını güncellemek.
REST ile her dakika sorgu atmak yerine, yalnızca olay gerçekleştiğinde bildirim almak hem kotanızı hem sunucunuzu korur.
Uç noktanızı hazırlamak
Kendi sunucunuzda POST kabul eden bir adres açarsınız. Gelen isteği hızlıca kabul edip işi arka plana atmak en doğru yaklaşımdır.
Yavaş yanıt veren uçlar yeniden deneme tetikler ve aynı bildirimi birden fazla kez alırsınız.
Güvenlik ve doğrulama
Gelen isteğin gerçekten bizden geldiğini doğrulamak için imza başlığı kullanılır. İmzayı doğrulamadan veriye güvenmeyin.
İmza X-Hasfiyat-Signature başlığında gelir: zaman damgası ve ham gövdeden gizli anahtarınızla üretilen HMAC-SHA256 değeridir. Uç adresinizi tahmin edilmesi zor tutun ve X-Hasfiyat-Timestamp değeri 5 dakikadan eski istekleri reddedin.
Tekrar gelen bildirimler
Ağ koşulları nedeniyle aynı bildirim birden fazla kez ulaşabilir. Her bildirimin benzersiz kimliğini (gövdedeki id alanı, X-Hasfiyat-Delivery başlığı) saklayıp tekrarları yok saymalısınız.
Bu, çift fiyat güncellemesi gibi istenmeyen sonuçları engeller.
İzleme ve hata ayıklama
Gelen bildirimleri en az birkaç gün loglayın. Sorun anında neyin geldiğini görmek çözümü hızlandırır.
Uç noktanız 8 saniye içinde 2xx dönmezse bildirim 15 saniye, 1 dakika ve 5 dakika sonra yeniden denenir. Adres 12 saat boyunca hiç başarılı yanıt vermezse webhook durdurulur; panelden yeniden etkinleştirebilirsiniz.
Sık sorulan sorular
Webhook ile REST farkı ne?
REST'te siz sorarsınız, webhook'ta sistem size haber verir. Webhook daha az istek üretir ve olay bazlı çalışır. Fiyat belirlediğiniz eşiği geçtiğinde pazaryeri güncellemesi tetiklemek gibi senaryolarda sürekli sorgu yapmanıza gerek kalmaz.
Bildirim gelmezse ne yapmalıyım?
Uç adresinizin herkese açık bir https adresi olduğunu ve 2xx döndüğünü kontrol edin. Panelin Webhook'lar sayfasında Test Et ile anında deneme yapabilir, Teslimler ile son gönderimlerin durum kodunu görebilirsiniz. Güvenlik duvarı, yönlendirme veya sertifika sorunları en sık karşılaşılan nedenlerdir; geçmişte dönen hata kodu yönü gösterir.
Aynı bildirim iki kez gelirse?
Benzersiz kimliği saklayıp tekrarları yok sayın. Bu ağ koşullarında normaldir ve dağıtık sistemlerde beklenen bir davranıştır. Kimliği kısa süreli bir tabloda ya da önbellekte tutmanız, aynı olayı iki kez işlemenizi önler.
İmza doğrulaması nasıl yapılır?
Gövde ve gizli anahtarla üretilen imza, başlıktaki değerle karşılaştırılır. Eşleşmiyorsa isteği reddedin. Karşılaştırmayı sabit zamanlı bir fonksiyonla yapmanız, imzayı deneme yanılmayla çözmeye çalışan saldırılara karşı koruma sağlar. Doğrulamadan geçmeyen istekleri sessizce reddetmeniz en güvenli davranıştır.
Kaç webhook tanımlayabilirim?
Starter paketinde 2, Pro'da 5, Enterprise'da 20 webhook tanımlanabilir; farklı eşikler için ayrı uçlar tanımlanabilir. Örneğin bir ucu vitrin güncellemesi, diğerini muhasebe bildirimi için kullanabilir, her birine farklı bir tetikleme eşiği verebilirsiniz. Uçlardan biri yanıt vermezse yalnızca o hedef etkilenir, diğerleri çalışmaya devam eder.
Canlı altın & döviz verisine hemen bağlanın
Dakikalar içinde REST veya WebSocket ile gerçek zamanlı fiyat akışına başlayın.