Bayi siparişlerini kendi yazılımınıza, depo sisteminize veya muhasebe programınıza otomatik aktarmanın iki yolu vardır: belirli aralıklarla "yeni sipariş var mı?" diye sormak ya da sipariş geldiği anda haber almak. İkincisine webhook denir. Bu yazıda farkı ve 360Katalog'da kurulumu adım adım anlatıyoruz.
Sorgulama ile webhook arasındaki fark
Sorgulamada (polling) yazılımınız örneğin her birkaç dakikada bir API'ye istek atar; sipariş yoksa bu isteklerin hepsi boşa gider, sipariş geldiğinde ise bir sonraki sorguya kadar beklersiniz. Webhook'ta ise olay gerçekleştiğinde 360Katalog sizin belirlediğiniz adrese bir istek gönderir. Daha az istek, daha hızlı aktarım.
Adım 1: Webhook adresinizi ekleyin
Firma panelinde API ve Webhook sayfasını açın, https ile başlayan adresinizi yazın ve dinlemek istediğiniz olayları seçin: order.created, order.status_changed, order.updated, product.updated, quote.accepted. İmza anahtarı (whsec_…) yalnızca oluştururken gösterilir; güvenli bir yere kaydedin.
Adım 2: İmzayı doğrulayın
Her istek X-360Katalog-Timestamp ve X-360Katalog-Signature başlıklarını taşır. İmza, zaman damgası, bir nokta ve ham istek gövdesi birleştirilerek anahtarınızla HMAC-SHA256 hesaplanır. Kendi tarafınızda aynı hesabı yapın, sonucu sabit süreli karşılaştırın ve 5 dakikadan eski zaman damgalarını reddedin. Böylece isteğin gerçekten 360Katalog'dan geldiğinden ve tekrar oynatılmadığından emin olursunuz. PHP ve Node.js örnekleri geliştirici dokümanında.
Adım 3: Hızlı yanıt verin, işi kuyruğa alın
Adresiniz 3 saniye içinde 2xx durum koduyla yanıt vermelidir. Siparişi muhasebe programına yazmak gibi uzun işleri bir kuyruğa alıp hemen yanıt verin.
Adım 4: Tekrar eden teslimatları ayıklayın
Başarısız teslimatlar 1 dk, 5 dk, 30 dk, 2 sa ve 6 sa sonra yeniden denenir. Bu yüzden aynı olay birden fazla kez gelebilir. Her olayın değişmeyen bir kimliği vardır (X-360Katalog-Event-Id); işlediğiniz kimlikleri saklayıp tekrarları atlayın.
Adım 5: Test edin ve günlüğü izleyin
Panelden "Test gönder" ile ping olayı yollayın. Her webhook için son 100 teslimat, gönderilen içerik ve aldığınız yanıtla birlikte panelde görünür ve tek tıkla yeniden gönderilebilir. Üst üste 50 başarısız denemeden sonra webhook otomatik durdurulur; sorunu giderip panelden yeniden etkinleştirebilirsiniz.
Sık sorulan sorular
Webhook için hangi adresleri kullanabilirim?
Adres https ile başlamalıdır. Yönlendirmeler (3xx) izlenmez; yerel veya özel ağ adreslerine gönderim yapılmaz.
Webhook gelmezse sipariş kaybolur mu?
Hayır. Sipariş 360Katalog'da kayıtlıdır; teslimat yeniden denenir ve panelden elle yeniden gönderilebilir. Ayrıca API ile değişen siparişleri tarihe göre sorgulayarak eksik kalanı tamamlayabilirsiniz.
Sipariş durumunu kendi sistemimden geri yazabilir miyim?
Evet. API ile sipariş durumunu, kargo firmasını ve takip kodunu güncelleyebilirsiniz; bayi bu bilgiyi "Siparişlerim" ekranında görür.
Sonuç
Webhook, siparişleri sürekli sorgulamadan anında almanın en sade yoludur. Muhasebe programınıza göre seçenekleri Logo, Mikro, Netsis bağlantısı yazısında karşılaştırdık.
