WebHook, modern web geliştirmede sıkça kullanılan ve tetiklemeye ihtiyaç duymayan bir API türüdür. Kısaca, bir uygulama içinde gerçekleşen belirli olayların (event) başka bir uygulamaya anında iletilmesini sağlayan mekanizmadır. WebHook’lar, HTTP protokolü üzerinden JSON formatında veri göndererek, uygulamalar arasında gerçek zamanlı veri akışı ve entegrasyon olanağı sunar. Bu sayede uygulamalar birbirini beklemeden, anlık olarak veri alışverişi gerçekleştirebilir.
WebHook, farklı yazılım sistemlerinin birbirine kolayca bağlanmasını ve otomasyon süreçlerinin oluşturulmasını sağlar. Örneğin, bir e-ticaret platformunda yeni bir sipariş oluşturulduğunda, WebHook kullanılarak sipariş bilgileri anında muhasebe, lojistik veya CRM sistemine iletilebilir. Bu yöntem, klasik API çağrılarından farklı olarak sürekli sorgulama yapmayı gerektirmez; ilgili olay meydana geldiğinde otomatik olarak tetiklenir ve belirlenen URL’e veri iletilir.
T-Soft altyapısı, işletmelerin çeşitli entegrasyon ihtiyaçlarını karşılamak üzere WebHook özelliğini destekler. WebHook lisansı, ek bir satın alma gerektirmeyen ancak aktif edilmesi gereken bir özelliktir. Lisansın açılması için destek ekibine, makalede belirtilen ücret tarifesini kabul ettiğinizi ve lisansın açılmasını istediğinize dair talepte bulunmanız yeterlidir. Öte yandan, WebHook üzerinden gerçekleştirilen veri gönderimleri ve istekleri belirli bir tarifeye tabidir; bu sayede yapılan işlemler sistemsel olarak takip edilebilir ve yönetilebilir.
T-Soft WebHook özelliği, işletmelerin sistemlerini dış uygulamalarla entegre ederek operasyonlarını daha hızlı ve verimli hale getirmelerine imkan tanır. Özellikle stok yönetimi, sipariş takibi, kampanya ve müşteri yönetimi gibi süreçlerde, WebHook kullanımı ile gerçek zamanlı veri akışı sağlanabilir ve otomasyon süreçleri güvenli bir şekilde yürütülebilir.
WebHook kullanımı ek bir ücretlendirmeye tabidir.
Lisans ücreti aylık en az 10 USD+KDV olarak faturalandırılır.
T-Soft siteleri arasında yapılan entegrasyonlar "Site İçi", farklı adreslerle yapılanlar ise "Site Dışı" olarak kabul edilir ve ücretlendirilir.
- 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
WEBHOOK KULLANIM ÖZELLİKLERİ
- "Ayarlar > Kontrol Merkezi" sayfasına tıklayın.
- "Webhook" sekmesine tıklayın.
- Yeni webhook eklemek için artı (+) butonuna tıklayın.
- Yük Adresi (Payload URL) : WebHook POST isteklerinin iletileceği sunucu adresidir. Bu adresin internette erişilebilir, aktif bir URL olması gerekir. Geçersiz bir URL girildiğinde olay bildirimi gönderilmez. URL geçerli olsa da bir HTTP hatası döndürüyorsa, bildirim otomatik olarak yeniden gönderilmek üzere sıraya alınır.
- İçerik Türü (Content Type) : WebHook’lar, olay bildirimlerini farklı içerik türleriyle iletebilir. Listeden size uygun olan içerik tipini seçerek gelen veriyi istediğiniz formatta işleyebilirsiniz. Desteklenen içerik türleri:
- application/json
- application/x-www-form-urlencoded
- Gizli Anahtar (Secret Key) : WebHook isteğinin gerçekten T-Soft sisteminden geldiğini doğrulamak için bir güvenlik anahtarı kullanabilirsiniz. Bu anahtar, istek sırasında header içinde X-Hub-Signature başlığıyla gönderilir. Bu başlığı kontrol ederek, isteğin doğruluğunu ve URL’nizin güvenliğini sağlayabilirsiniz. “Oluştur” butonuna tıklayarak gizli anahtarı oluşturabilirsiniz.
- Zaman Aşımı (Timeout) : Zaman aşımı, WebHook isteğinin yanıt bekleme süresini belirlediğiniz alandır. Bu süre, web kancası üzerinden gerçekleştirilen işlemlerin maksimum çalışma süresini ifade eder. Belirlenen süre sonunda işlem tamamlanmazsa istek sonlandırılır. Seçtiğiniz süreye göre, event’ler içerisindeki veriler bu zaman diliminde çekilip işlenecektir.
- İstek süresini, verilerin alınma veya kaydedilme hızınıza göre belirlemelisiniz. Örneğin, her isteği ortalama 7 saniye içinde kontrol edip kaydediyorsanız, 3 saniyelik bir süre seçmeniz uygun değildir. Bu durumda veriler kaydedilmeyebilir. Zaman aşımı değerleri sırasıyla 3, 5 ve 7 saniye olarak denenir. Fiyatlandırma, zaman aşımı denemelerinin süresine göre tarafınıza yansıtılır. Seçiminizi yaptıktan sonra “Test Et” butonuna tıklayarak işlemi doğrulayabilirsiniz.
- Olaylar (Events) : Oluşturduğunuz WebHook ile veri aktarımı yapılacak işlemleri bu alandan seçebilirsiniz.
- NOT : Sipariş öncesi olayları ile ilgili işlemler, ek WebHook lisansı gerektirir. Bu özelliği kullanmak için destek ekibimizle iletişime geçerek ilgili lisansın aktif edilmesini talep edebilirsiniz.
- Bu sekme üzerinde, oluşturduğunuz tüm WebHook kayıtlarını ve seçilen olay durumlarını görüntüleyebilirsiniz.
- Ping : Eklenen WebHook’un çalışma durumunukontrol etmek için ping gönderimi yapabilirsiniz. Gönderilen ping’in sonucunu “Geçmiş” butonuna tıklayarak inceleyebilirsiniz.
- Geçmiş : WebHook ile gerçekleşen işlemleri ve aktarım listesine düşen logları bu alandan görüntüleyebilirsiniz.
- WebHook işleminin detaylarını görüntüleyebilir ve filtre alanını kullanarak belirli olaylar arasında arama yapabilirsiniz.
- ID : Her gerçekleşen WebHook olayı için sistem tarafından benzersiz bir ID oluşturulur.
- Olay : Gerçekleşen işlemin olay tipini bu alandan görüntüleyebilirsiniz.
- HTTP Kodu : WebHook olayının başarılı olup olmadığını bu alandaki HTTP durum kodları ile takip edebilirsiniz. Örneğin: 200 başarılı, 500 başarısız vb. kodlar listelenir.
- Yanıt Süresi : WebHook isteğinin gönderiminden yanıt alınmasına kadar geçen süreyi bu alandan görebilirsiniz. Zaman aşımı ayarını, dönen yanıt süresine göre belirleyebilirsiniz.
- Tarih : Olayların gerçekleştiği tarih ve saat bilgilerini bu alandan görüntüleyebilirsiniz.
- İşlemler : Gerçekleşen her olayın işlem detaylarını bu alandan görüntüleyebilirsiniz.
- İstek (Request) : WebHook’a gönderilen isteğin detaylarını görüntüleyebileceğiniz sekmedir. Bu alanda HTTP metodu, URL, header bilgileri ve içerik tipleri gibi gönderilen tüm teknik detaylar yer alır.
- Yanıt (Response) : WebHook isteğine sunucudan dönen yanıtın detaylarını görüntüleyebileceğiniz sekmedir. HTTP durum kodu, yanıt içeriği ve varsa hata mesajları bu bölümde listelenir. Bu sekme, isteğin başarılı olup olmadığını ve sunucunun yanıt süresini kontrol etmek için kullanılır.
- Yük (Payload) : WebHook ile gönderilen verinin kendisini görüntüleyebileceğiniz sekmedir. JSON veya form-data formatındaki asıl veri, bu sekmede açık bir şekilde listelenir ve hangi bilgilerin gönderildiğini detaylı olarak inceleyebilirsiniz.
- Düzenle : WebHook kurulum bilgilerini düzenleyebilirsiniz.
- Sil : Ekli WebHook kayıtlarını silebilirsiniz.
- Kayıtları Göster : WebHook oluşturma, düzenleme ve silme işlemlerine ait log kayıtlarını bu alandan görüntüleyebilirsiniz.
- Log kayıtlarında, WebHook bilgilerini, gerçekleştirilen işlem türünü ve işlemi yapan panel kullanıcısına ait detayları ayrıntılı şekilde inceleyebilirsiniz.
WEBHOOK TEST İŞLEMİ SAĞLAMA
- WebHook özelliği sayesinde site ve demolarınızda sanal ortamda entegrasyon testleri gerçekleştirebilir, WebHook olay tiplerinin içeriklerini JSON formatında görüntüleyebilirsiniz. Test işlemleri için webhook.site adresini kullanabilirsiniz. Siteye ilk girişte test amaçlı benzersiz bir “Your Unique URL” oluşturulur. Bu URL’yi kopyalayarak test süreçlerinizde kullanabilirsiniz.
- Yeni bir test URL’si oluşturmak veya mevcut URL’yi değiştirmek isterseniz, sayfanın sağ üst kısmında yer alan “New” seçeneğini kullanabilirsiniz.
- Oluşturulan benzersiz “Your Unique URL” bilgisini, oluşturduğunuz WebHook detayında yer alan “Yük Adresi” alanına ekleyin. Ardından “Test” butonuna, sonrasında “Kaydet” butonuna tıklayarak işlemi tamamlayın. WebHook detayındaki diğer alanları ise, önceki slaytlarda yer alan içeriklere göre düzenleyebilirsiniz.
- Yük Adresi tanımlandıktan sonra, WebHook’un çalışma durumunu kontrol etmek için “Ping” butonuna tıklayın.
- WebHook üzerinden gelen istekleri webhook.site sayfasında görüntüleyebilirsiniz. Seçtiğiniz olaylara bağlı olarak gönderilen istekler, belirlenen zaman aşımı süresine göre siteye iletilecektir.
- Gelen isteklerin üzerine tıkladığınızda, ilgili isteğin içeriğini detaylı olarak görüntüleyebilirsiniz.