WebHook (Web Kancası) tetiklenmeye ihtiyaç duymayan bir API çeşididir.
WebHook, farklı uygulamaların birbirleri ile entegrasyon sağlayabilmeleri için uygulama içerisinde oluşan event’leri HTTP üzerinden JSON Payload’ları ile kendilerine abone olan diğer uygulamaları tetiklemesidir.
Web geliştirmede bir web kancası, bir web sayfasının veya web uygulamasının davranışını özel geri aramalarla artırma veya değiştirme olanağı sunmaktadır.
WebHook sağlayan servisler, bizi ilgilendiren bir olay gerçekleştiğinde bizim tanımladığımız bir URL’e HTTP isteği atarak uygulamamızı haberdar ederler. Bir nevi back-end’ler kendi aralarınde event gönderirler. Bu sayede yazılımımız gerçek zamanlı (real-time) olarak olaydan haberdar olur ve alması gereken aksiyonları alır. Belirli bir olay meydana geldiğinde bir uygulamadan diğerine gerçek zamanlı veri göndermenizi sağlayarak, uygulamalarınızın birbirine anında ve sorunsuz bir şekilde veri aktarmasına olanak tanır.
T-Soft altyapısı ile çeşitli entegrasyon işlemleri için WebHook özelliğini kullanabilirsiniz.
WebHook özelliği ek lisansa bağlı olarak çalışmaktadır. Lisansı aktif ettirmek için destek ekibimize talep oluşturabilirsiniz. (Webhook lisansı satın alınması gereken bir lisans değildir. Aşağıda iletilen istek ücretlerini kabul ediyorsanız lisansınızın açılmasını destek ekibinden talep edebilirsiniz.)
WebHook ile işlem sağlanırken ayrı olarak gönderim süre ve isteklerinde ücret tarifesi uygulanmaktadır.
- "Ayarlar > Kontrol Merkezi" sayfasına tıklayınız.
- "Webhook" sekmesine tıklayınız.
- Ayarlar : Webhook kullanımında bulunan genel ayarlara ulaşabilirsiniz.
- Doküman : Webhook kullanımı ile ilgili genel doküman içeriğine ulaşabilirsiniz.
- İstatistikler : Webhook aktarım istatistiklerine ulaşabilirsiniz.
- Kayıtları Görüntüle : Eklenen webhookta yapılan düzenleme, ekleme ve silme işlemlerine ait logları görüntüleyebilirsiniz.
- Yeni bir web kancası eklemek için "Yeni Ekle" butonuna tıklayınız.
- Yük Adresi (Payload URL) : WebHook POST isteklerini alacak sunucunun URL'sidir. URL webte barınan canlı bir adres olmalıdır. Geçersiz bir URL girildiğinde olay bildirimi gitmez. URL geçerli fakat bir http hatası veriyorsa sonradan tekrar denenmek üzere sıraya alınır.
- İçerik Türü (Content Type) : WebHooklar farklı İçerik tipleriyle olay bildirebilir. Seçenekler içerisinden size uygun olan içerik tipini seçip veriyi istediğiniz gibi işleyebilirsiniz.
- application/json
- application/x-www-form-urlencoded
- Gizli Anahtar (Secret Key) : İstek atılan URL'ye gerçekten web kancanın verisinin geldiğini doğrulamak için bir güvenlik verisi yollayabilirsiniz. Bu veri header'da "X-Hub-Signature" başlığıyla gönderilecektir. Bu başlığı kontrol ederek istek URL'nizin güvenliğini sağlayabilir ve doğrulayabilirsiniz. "Oluştur" butonuna tıklayarak gizli anahtarı oluşturabilirsiniz.
- Zaman Aşımı (Timeout) : Zaman aşımı; web kancası isteklerinin süresini belirlediğiniz alandır. WebHook üzerinden gerçekleştiren işlemlerin istek süresini belirleyebilirsiniz. Seçtiğiniz süreye göre eventlerınız içerisindeki veriler çekilecek ve işlenecektir. İstek sürenizi verilerin alınma veya kaydedilme süresine göre seçmelisiniz. Her isteği ortalama 7 saniye içerisinde kontrol edip kaydediyorsanız süreyi 3 seçmemelisiniz. Bu durumda kaydedilmeme sorunu oluşabilir. Zaman aşımlarınızın süreleri sırasıyla 3, 5 ve 7 saniye olarak denenir ve fiyatlandırma zaman aşımlarının denenme süresine bağlı olarak tarafınıza yansıtılır. Seçim sonrasında "Test Et" butonuna tıklayınız.
- Olaylar (Events) : Oluşturulan webhook ile veri aktarımı sağlamak istediğiniz işlemleri seçiniz. Sipariş öncesi olayları ile alakalı işlemler ek webhook lisansına bağlıdır. Kullanmak için destek ekibinden ilgili lisansında aktif edilmesini talep edebilirsiniz.
- Oluşturulan tüm webhooklar sekme içerisinde listelenir.
- Ping : Eklenen webhook işleminin çalışma durumunu ping göndererek kontrol edebilirsiniz. Ping sonucunu geçmiş butonuna tıklayarak inceleyebilirsiniz.
- Geçmiş : Webhook içerisinde gerçekleşen ve aktarım listesine düşen logları görüntüleyebilirsiniz. Geçmiş işlemlerde; işlem durumunu, işlem türünü, tarih ve tepki süresi gibi bilgileri görebilirsiniz. İşlem detaylarında istek, tepki ve yük içeriklerini inceleyebilirsiniz
- Düzenle : Webhook kurulum bilgilerini düzenleyebilirsiniz.
- Sil : Ekli web kancalarını silebilirsiniz.
WebHook kullanımında ek ücretlendirme tarifesi uygulanmaktadır. Tarife bilgisini aşağıdaki listeden inceleyebilirsiniz.
Webhook lisansı kullanımında aylık en az 10 USD+KDV şeklinde faturalandırma yapılmaktadır.
- Site İçi
0,001 USD + KDV → Site İçi 3 sn WebHook
0,002 USD + KDV → Site İçi 5 sn WebHook
0,003 USD + KDV → Site İçi 7 sn WebHook
- Site Dışı
0,002 USD + KDV → Site Dışı 3 sn WebHook
0,003 USD + KDV → Site Dışı 5 sn WebHook
0,004 USD + KDV → Site Dışı 7 sn WebHook