Webhook nedir? sona.to webhook'ları nasıl çalışır

Webhook nedir? Bir uygulamanın, bir şey olduğu anda başka bir uygulamaya gönderdiği mesajdır; böylece ikinci uygulama sürekli sormak zorunda kalmaz. İlk uygulamaya bir adres verirsiniz, o da her olayın ayrıntılarını olay gerçekleşir gerçekleşmez oraya gönderir. Bu rehber webhook'ların nasıl çalıştığını, bir webhook'un gerçek olup olmadığını nasıl kontrol edeceğinizi ve sona.to'nun ne gönderdiğini anlatır; bunlar webhook sayfasında da özetlenir.

Webhook nedir?

Çoğu uygulama veriyi iki yolla paylaşır. API ile sisteminiz sorar: "gönderi yayınlandı mı?", cevap hayırsa daha sonra yine sorar. Webhook ile uygulama size haber verir: gönderi yayınlandığında, seçtiğiniz bir adrese gönderinin ayrıntılarını içeren bir istek gönderir.

Yani webhook, kontrolünüzdeki bir URL'ye gönderilen bir HTTP isteğidir, genellikle JSON gövdeli bir POST. Bu URL kendi sunucunuz olabilir ya da n8n, Zapier, Make, Slack veya istek geldiğinde bir iş akışı başlatan başka bir hizmetin verdiği bir webhook adresi olabilir.

Webhook ve API farkı

API sormak ve değiştirmek içindir: gönderileri listelemek, gönderi oluşturmak, rakamları okumak. Webhook ise haber almak içindir. Çoğu entegrasyon ikisini birlikte kullanır: gönderi oluşturmak için API, gönderinin ne zaman yayınlandığını ya da başarısız olduğunu öğrenmek için webhook. Bir API'ye tekrar tekrar sormak istekleri boşa harcar ve olayı yine de geç öğrenirsiniz, webhook ise olay olur olmaz gelir.

Webhook nasıl doğrulanır

Webhook adresinizi bilen herkes ona sahte bir istek gönderebilir, bu yüzden iyi yapılmış bir webhook imzalıdır. Gönderen taraf gövdeden ve paylaşılan bir gizli anahtardan, genellikle HMAC SHA-256 ile bir imza hesaplar ve bunu bir başlığa koyar. Sizin tarafınız aynı gizli anahtarla aynı imzayı hesaplar ve ikisini sabit zamanlı bir karşılaştırmayla karşılaştırır. Farklılarsa istek yok sayılır.

İmzalanan verilere bir zaman damgası eklemek tekrar saldırılarını da önler: bir kez ele geçirilen bir istek daha sonra yeniden gönderilemez, çünkü zaman damgası çok eski kalır.

sona.to'da webhook'lar

sona.to dört olay için webhook gönderir: bir gönderi yayınlandı, bir gönderi başarısız oldu, bir site denetimi tamamlandı ve bir site denetimi başarısız oldu. Her webhook'un hangi olayları alacağını siz seçersiniz; böylece bir sohbet bildirimi yalnızca hataları dinlerken bir rapor e-tablosu her şeyi alabilir. Gönderilen veri, sona.to API'si ile aynı alan adlarını kullanır.

Kurulum. Panelinizin API sayfasında adresi yapıştırın, olayları işaretleyin ve kaydedin. İmzalama anahtarı yalnızca o anda bir kez gösterilir, o yüzden hemen kopyalayın.

İmza. Her teslimat, bir zaman damgası ve zaman damgası ile gövdenin anahtarınızla oluşturulmuş HMAC SHA-256 değerini içeren bir başlık taşır. Zaman damgası birkaç dakikadan eski olan istekleri reddedin.

Yeniden denemeler. Adresiniz erişilemiyorsa ya da hata döndürürse teslimat 60 saniye, 5 dakika ve 30 dakika sonra yeniden denenir. Her deneme durum kodu ve süresiyle kaydedilir. Hata vermeye devam eden bir adres kapatılır, düzelttikten sonra yeniden açabilirsiniz.

Güvenlik. Adres https kullanmalı ve herkese açık bir sunucuyu göstermelidir. Özel ağlardaki adresler kaydederken ve teslimatta yeniden reddedilir, yönlendirmeler de takip edilmez.

n8n, Zapier ve Make ile webhook'lar

n8n, Zapier ve Make için sona.to uygulamalarında aynı dört olay için hazır tetikleyiciler bulunur, bu yüzden adresi kendiniz yapıştırmanız gerekmez: tetikleyiciyi ekleyin, uygulama webhook'u kendisi kurar. n8n, Zapier ve Make ile sosyal medya otomasyonuna bakın.

İmza kontrolü örneğiyle birlikte tüm ayrıntılar API dokümantasyonunda yer alır.

Sık sorulan sorular

Webhook ile API aynı şey mi?

Hayır. API siz sorduğunuzda cevap verir. Webhook bir şey olduğunda size mesaj gönderir.

sona.to webhook'ları ücretsiz mi?

Webhook'lar, API ile birlikte tüm planlarda vardır.

Sunucum çalışmıyorsa ne olur?

sona.to yaklaşık yarım saat içinde üç kez yeniden dener. Teslimatlar başarısız olmaya devam ederse webhook, siz yeniden açana kadar kapatılır.