Hangi Değişiklik Bildirilmelidir?
Ticimax webhook yapısında sipariş durumu ve sipariş ürün durumu için bildirimler tanımlanabilir. İncelemenin başlangıcı hangi olayın dış uygulamaya ulaşmasının beklendiğini belirlemektir. Siparişin bir ürünündeki değişiklikle bütün siparişin durumu aynı bilgi değildir.
AdPix örneğinde iki ürünlü siparişin yalnızca biri kargoya verilir. Entegrasyonun bütün siparişi teslim edilmiş sayması istenmez. Beklenen bildirim türü yanlış seçilmişse bağlantı adresi çalışsa bile doğru iş tetiklenmez. Bu nedenle sorun kaydında olay, sipariş ve varsa ilgili ürün belirtilir; yalnızca “webhook gelmiyor” ifadesiyle yetinilmez.
Özellik ve Hedef Servis Kontrolü
Webhook kullanımı için ilgili özelliğin mağazada etkin olması gerekir. Tanımda olayın gönderileceği servis adresi bulunur. Kaydın panelde durması, alıcı uygulamanın bu adrese gelen isteği doğru işlediğini göstermez.
AdPix’in önerisi alıcı servisin erişilebilirliğini ve olayın uygulama kayıtlarına ulaşıp ulaşmadığını ayrı kontrol etmektir. Adres değişmiş, uygulama başka sunucuya taşınmış veya erişim kuralı yenilenmiş olabilir. Bildirim ulaşmış fakat işlenmemişse olayın hiç gönderilmediği sonucuna varılmaz. Hedef servis kaydı, gelen istek ve uygulamanın sonucu aynı örnek sipariş üzerinden eşleştirilir.
Webhook İşlemi ve Bildirim Adresi
Webhook tablosunda izlenecek işlem, hedef URL ve kimlik doğrulama alanları bulunur. Sipariş olayının doğru seçilmesi, gönderilen bildirimin anlamını belirler. Hedef sunucunun yanıtı ve ilgili siparişin karşı sistemde işlenmesi ayrıca takip edilir.
Kimlik Bilgileri ve Kayıtların Korunması
Webhook tanımındaki kullanıcı adı ve şifre gönderilen parametreler arasında yer alır. Alıcı servisin doğrulama yapması ve bu bilgilerin uygulama loglarında açık biçimde tutulmaması gerekir. Teknik destek amacıyla paylaşılan örnekler de gizli değerlerden arındırılmalıdır.
WS yetki kodu yönetimi ayrı bir erişim mekanizmasıdır. AdPix incelemesinde olay bildirimi alma ile API üzerinden veri sorgulama izinleri karıştırılmaz. Uygulama ek bilgi okuyacaksa ilgili servis erişimi ayrıca değerlendirilir. Her sorunu bütün yetkileri açarak çözmeye çalışmak yerine hangi bağlantının hangi işi yaptığı belirlenir ve gereksiz erişimler verilmez.
Ürün ve Miktar Bilgisini Doğru Yorumlayın
Ürün durumu bildiriminde sipariş ürün kimliği ve değişen adet gibi bilgiler bulunur. Kısmi iptal veya kısmi sevkiyat durumunda bu ayrıntılar önem taşır. Dış uygulamanın yalnızca genel sipariş numarasına göre işlem yapması ürünler arasında karışıklık yaratabilir.
AdPix’in örneğinde aynı üründen üç adet alan müşteri birini iptal eder. Doğru sonuç kalan iki adedin takibinin sürmesidir. Alıcı uygulamanın toplam siparişi kapatması hatalı olur. İnceleme sırasında bildirilen ürün kimliği, işlem türü ve adet aynı sipariş satırıyla karşılaştırılır. Müşteri bilgileri yalnızca gerekli kapsamda kullanılır.
Tekrarlanan İşlemler İçin Kontrol
Alıcı uygulama aynı olaya bağlı işlemi tekrar çalıştırdığında ikinci sevkiyat veya ikinci stok hareketi üretmemelidir. Bu, entegrasyon tasarımında değerlendirilmesi gereken bir koşuldur; sağlayıcının belgelenmemiş tekrar deneme süresi hakkında varsayım yapılmaz.
AdPix’in önerisi bir örnek olayın alınma ve işlenme sonucunu izlenebilir tutmaktır. İşlem başarısız olduğunda hangi kısmın tamamlandığı bilinir. Son kontrolde tam sipariş değişikliği, tek ürün değişikliği ve kısmi miktar senaryosu ayrı denenir. Elde edilen sonuçlar beklenen operasyonla karşılaştırılır. Böylece bildirim geldiği hâlde yanlış iş yapan bağlantı da yalnızca bağlantı testiyle gözden kaçmaz.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- Webhook
- Webhook, bir sistemde sipariş oluşması ya da ödeme tamamlanması gibi bir olay gerçekleştiğinde olay bilgisini önceden kaydedilmiş bir adrese HTTP isteğiyle kendiliğinden gönderen bildirim yöntemidir.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
Ticimax