Harici bir entegrasyon için webhook nasıl yapılandırılır?
Webhook yapılandırması, harici bir uygulamanın olay bilgilerini alıcı bir sisteme göndermesine olanak tanır, gerekli webhook işlevselliği destekleniyorsa.
Webhook yapılandırması, sağlayıcılara göre değişir ve uç nokta URL'leri, kimlik doğrulama bilgileri, olay abonelikleri ve yük formatları gibi teknik ayarlar gerektirebilir.
Webhook yapılandırmadan önce
Şunları anladığınızdan emin olun:
1. Hangi uygulama olayı üretiyor.
2. Hangi olay işlemi başlatmalıdır.
3. Hangi sistem webhook'u alacak.
4. Webhook'un hangi bilgileri içereceği.
5. Alıcı sistemin isteği nasıl doğruladığı.
6. Olay alındıktan sonra hangi eylemin gerçekleşmesi gerektiği.
Webhook bağlantısını hazırlama
Adım 1: Olay kaynağını belirleyin.
Hangi harici uygulamanın webhook'u üreteceğini belirleyin.
Adım 2: Sağlayıcının belgelerini gözden geçirin.
Sağlayıcının gerekli olayı ve webhook teslimat yöntemini desteklediğini doğrulayın.
Adım 3: Alıcı uç noktasını belirleyin.
Bir webhook, geçerli bir varış URL'si gerektirir.
İstediğiniz iş akışı Polyosync'in olayı almasını gerektiriyorsa, bu yapılandırma için desteklenen bir gelen webhook uç noktasının mevcut olduğundan emin olun.
Genel bir Polyosync web sitesi URL'sini özel bir webhook uç noktası ile değiştirmeyin.
Adım 4: Kimlik doğrulamayı yapılandırın.
Destekleniyorsa, gerekli imza sırrını, yetkilendirme yöntemini veya diğer doğrulama mekanizmasını yapılandırın.
Adım 5: Olay türlerini seçin.
Sadece hedef iş süreci ile ilgili olaylara abone olun.
Adım 6: Yükü gözden geçirin.
Gönderilecek alanları belirleyin ve hangi bilgilerin gerekli olduğunu belirleyin.
Adım 7: Alıcı işlemi yapılandırın.
Destekleniyorsa, gelen olayı uygun işleme mantığı veya iş akışı ile bağlayın.
Adım 8: Test olayı gönderin.
Sağlayıcının test işlevselliğini kullanın, eğer mevcutsa.
Adım 9: Sonucu doğrulayın.
İsteğin doğru uç noktaya ulaştığını ve beklenen sonucu ürettiğini doğrulayın.
Adım 10: Hata yönetimini gözden geçirin.
Başarısız teslimatlar, yinelenen olaylar ve geçersiz isteklerin nasıl yönetileceğini belirleyin.
Webhook uç noktası nedir?
Webhook uç noktası, başka bir uygulamadan HTTP isteklerini almak için tasarlanmış bir URL'dir.
Alıcı sistem, gerekli istek işleme ve doğrulamayı uygulamalıdır.
Herhangi bir URL'yi webhook uç noktası olarak kullanabilir miyim?
Hayır.
Hedef, beklenen istek yöntemi, yük formatı, kimlik doğrulama mekanizması ve işleme davranışını desteklemelidir.
Webhook'un teslim edilip edilmediğini nasıl anlarım?
Birçok sağlayıcı, teslimat günlükleri veya olay geçmişleri sunar.
Mevcut olduğunda, HTTP yanıt durumunu, teslimat zamanını ve hata bilgilerini kontrol edin.
Başarılı bir teslimat, tüm iş akışının başarılı olduğu anlamına mı gelir?
Kesinlikle değil.
Başarılı bir HTTP yanıtı, alımın onayını verebilir, ancak her bir aşağı akış iş operasyonunun tamamlandığını onaylamaz.
Bir olay iki kez gönderildiğinde ne olur?
Bazı sağlayıcılar teslimatı yeniden dener.
Alıcı işlem, istenmeyen yinelenen eylemleri önleyecek şekilde tasarlanmalıdır.
Güvenlik önerileri
HTTPS kullanın, gelen istekleri doğrulayın, imza sırlarını koruyun ve yetkisiz olayları reddedin.
Webhook kimlik bilgilerini asla kamu belgelerinde veya ekran görüntülerinde açığa çıkarmayın.
Önerilen yaklaşım
Ek olaylar veya iş açısından kritik eylemler eklemeden önce webhook'u tek bir olay türü ile test edin.
Olayın üretilmesinden nihai iş sonucuna kadar tüm süreci doğrulayın.