Şimdiye kadar bir gönderinin çıkıp çıkmadığını öğrenmek sormayı gerektiriyordu. API'yi çağırıyor, durumu kontrol ediyor, sonra tekrar çağırıyordunuz. İşe yarar ama bu bir sorgulamadır: ya çok sık sorup istek harcarsınız ya da çok seyrek sorup geç öğrenirsiniz. Webhook'lar bunu tersine çevirir. sona.to'ya bir adres verirsiniz, sona.to da bir şey olduğu anda sizi arar. Artık tüm planlarda mevcutlar.
Abone olunabilecek dört olay var ve tepki vermeye değer sonuçları kapsıyorlar: gönderi yayınlandı, gönderi başarısız oldu, site denetimi tamamlandı ve site denetimi başarısız oldu. Her webhook'un hangilerini alacağını siz seçersiniz, böylece bir Slack bildirimi yalnızca hataları dinlerken bir raporlama hattı her şeyi alabilir. Yük, REST API'nin döndürdüğü alan adlarının aynısını kullanır, yani bir GET isteğinden zaten ayrıştırdığınız şey değişmeden çalışmaya devam eder.
Kurulum bir dakika sürer. Panonuzdaki API sayfasını açın, aracınızın verdiği adresi yapıştırın, istediğiniz olayları işaretleyin ve kaydedin. İmzalama anahtarı o anda bir kez görünür. Hemen kopyalayın, çünkü bir daha gösterilmez.
Bir isteğin gerçek olduğunu o anahtar sayesinde anlarsınız. Her teslimat, bir zaman damgası ve o zaman damgası ile istek gövdesinden anahtarınızla hesaplanmış bir HMAC SHA-256 içeren bir imza başlığı taşır. Kendi tarafınızda yeniden hesaplayın ve ikisini sabit zamanlı bir fonksiyonla karşılaştırın. Zaman damgası imzalanan verinin parçası olduğu için, yakalanmış bir istek daha sonra size karşı yeniden oynatılamaz. Birkaç dakikadan eski olan her şeyi reddedin, bu kadar yeter.
Teslimatlar ilk sorunda pes etmez. Uç noktanız kapalıysa veya hata döndürüyorsa istek 60 saniye, ardından 5 dakika, ardından 30 dakika sonra yeniden denenir. Her deneme durum kodu ve süresiyle kaydedilir, böylece sorun çıkaran bir uç nokta tahmin edilecek değil, incelenecek bir şey olur. Sürekli başarısız olan bir uç nokta otomatik olarak kapatılır, düzelttikten sonra tekrar açabilirsiniz.
Onu yönlendirmek için akla gelen ilk yer bir otomasyon platformudur. Zapier, Make ve n8n size yapıştırmanız için bir webhook adresi verir ve olay, sonrasında gelecek şeye bağlanmaya hazır JSON olarak ulaşır: bir kanala mesaj, bir tabloya satır, bir takip aracına görev. Kendi sunucunuz da tam olarak aynı şekilde çalışır, arada platform olmadan.
sona.to'nun neyi kabul ettiğine dair bir not. Hedef https kullanmalı ve genel bir adres olmalıdır. Özel bir ağa çözümlenen bir adres hem kaydederken hem de teslimat anında yeniden reddedilir ve yönlendirmeler takip edilmez. Bir alıcıyı yerel ağda barındırıyorsanız, onu genel bir ana bilgisayar adının veya bir tünelin arkasına koyun.
Webhook'lar, panonun dışından sona.to'yu yönetmenin üçüncü yolu olarak REST API ve MCP sunucusunun yanına katılıyor. API sormak içindir, MCP bir yapay zekâ asistanının size sorması içindir, webhook'lar ise size haber verilmesi içindir. İmza doğrulama örneği dahil tüm ayrıntılar API belgelerinde.