Webhook
Tanım
Webhook, bir şey olduğu anda platformun seçtiğiniz bir adrese gönderdiği otomatik HTTP isteğidir; örneğin yeni bir sipariş ya da stok düşüşü. Diğer sistemlerinizin değişiklikleri tekrar tekrar sormasını beklemek yerine veriyi onlara gerçek zamanlı iletir. Her çağrı bir imza taşır; böylece alıcı, isteğin platformdan geldiğini doğrulayabilir.
Mağazanız için neden önemli
Mağazaların çoğu başka bir şeye bağlıdır: bir muhasebe aracına, bir depoya, bir CRM'e ya da birinin güncel tuttuğu bir tablo dosyasına. Webhook olmadan bu sistemler ya mağazayı birkaç dakikada bir yoklar, ki bu hem israftır hem de yine geç kalır, ya da biri veriyi elle kopyalar. Webhook varsa yeni bir sipariş, verildikten saniyeler sonra muhasebe aracında belirir.
Webhook'lar ters yönde de çalışır. Ödeme sağlayıcıları, kargo firmaları, pazaryerleri ve fatura entegratörlerinin hepsi; bir ödeme sonucunu, bir teslimatı, yeni bir siparişi ya da kabul edilmiş bir faturayı bildirmek için mağazaya webhook gönderir. Bir platformun gelen webhook'ları nasıl ele aldığı, yani imzaları doğrulaması ve tekrarları yok sayması, gönderdikleri kadar önemlidir.
Kambloo bunu nasıl ele alıyor
Yönetim panelinde; bir hedef adres, istediğiniz olaylar ve bir gizli anahtarla bir webhook aboneliği kaydedersiniz. Kullanılabilir olaylar; sipariş yaşam döngüsünü (oluşturuldu, ödendi, gönderildi, iptal edildi), ürün değişikliklerini (oluşturuldu, güncellendi, silindi), yeni müşterileri ve düşük stoğu kapsar. Her gönderim, sunucunuzun gizli anahtarla doğruladığı bir HMAC-SHA256 başlığıyla imzalanmış bir JSON POST isteğidir.
Başarısız gönderimler, üstel geri çekilmeyle beş kez yeniden denenir. Üç gün boyunca sürekli hata veren bir adres otomatik olarak duraklatılır ve size bildirilir. Panel, son 100 gönderimi istek ve yanıt özetleriyle ve herhangi birini yeniden gönderecek bir düğmeyle gösterir.
Ödeme sağlayıcılarından, pazaryerlerinden, kargo firmalarından ve fatura entegratörlerinden gelen webhook'lar mağaza başına merkezî bir adrese ulaşır, hiçbir şey işlenmeden önce imzayla doğrulanır ve olay kimliğine göre tekilleştirilir; böylece bir sağlayıcının yeniden denemesi asla ikinci bir sipariş ya da mükerrer bir ödeme kaydı oluşturmaz.
Webhook hakkında sorular
Webhook ile API arasındaki fark nedir?
API'de sisteminiz veriyi istediği zaman platformdan ister. Webhook'ta ise bir şey olduğunda platform sisteminize haber verir. Entegrasyonların çoğu ikisini birden kullanır: olayları öğrenmek için webhook'lar, onlara göre işlem yapmak için API.
Bir webhook gönderildiğinde sunucum kapalıysa ne olur?
Kambloo, aralarındaki süreyi artırarak beş kez yeniden dener. Bir adres üç gün boyunca sürekli hata verirse duraklatılır ve size bildirilir. Her gönderim kaydedilir ve elle yeniden gönderilebilir.