Webhook mu API mi? HR-Tech Verilerini Bordroya Aktarmanın İki Yolu

Webhook mu API mi sorusu neden yanlış başlıyor

Webhook mu API mi sorusu, İK ve saha takip sistemini bordro ya da ERP tarafına bağlamaya karar veren hemen her ekibin önüne çıkar — ve genelde yanlış soru olarak çıkar. Çünkü ikisi rakip değil, farklı işi çözen iki araçtır. Webhook bir olay olduğu anda sizi haberdar eder; API ise siz istediğinizde veriyi çeker. Sorunu "hangisi daha iyi" diye kurgulamak, entegrasyonun ilk gününde yanlış tarafı seçmenize yol açar; doğru soru "hangi veri, hangi anda, kimin isteğiyle taşınmalı" sorusudur.

Bu ayrımı gözden kaçırmanın bedeli küçük değil. Yanlış seçilen entegrasyon modeli ya bordro tarafında gecikmiş, geç fark edilen ihlal kayıtlarına yol açar ya da tam tersi: her dakika gereksiz sorgu atan, sistemi yoran bir entegrasyon kurulur. HR-Tech gibi saha dışı ihlalleri ve onay olaylarını gerçek zamanlı üreten bir platformda bu fark özellikle görünür hale gelir, çünkü olaylar günün her saatinde, öngörülemeyen anlarda oluşur.

İki entegrasyon modeli birbirini nasıl tamamlar

Webhook, sisteminizin dinleyici modda olduğu bir modeldir: platform bir olay ürettiğinde (bir saha dışı ihlali, tamamlanan bir onay), sizin belirlediğiniz adrese anında bir bildirim gönderilir. Siz bir şey sormazsınız, olay size gelir. REST API ise tam tersi yönde çalışır: siz ne zaman isterseniz, personel, puantaj ya da olay verisini çekersiniz. Sorgu sizin kontrolünüzdedir, zamanlama da öyle.

Pratikte çoğu kurumsal entegrasyon ikisini birlikte kullanır. HR-Tech'in entegrasyon katmanında da bu ayrım aynen böyle kurgulanmıştır: imzalı webhook ihlal ve onay olaylarını anlık olarak dışarı iletirken, salt okunur REST API personel, puantaj ve olay verisini istendiğinde açar. Biri "şimdi oldu, haberdar ol" der, diğeri "bana şu anki tabloyu ver" der — ve bir bordro entegrasyonunun büyük kısmı aslında ikisine de aynı anda ihtiyaç duyar.

Webhook ne zaman doğru seçim

Webhook, gecikmenin maliyetli olduğu her senaryoda doğru araçtır. Bir çalışan mesai içinde saha dışına çıktığında, bu bilginin bordro ya da güvenlik sisteminize dakikalar içinde ulaşması gerekiyorsa, periyodik sorgulama (polling) bu işi asla aynı hızda yapamaz. Beş dakikada bir sorgu atan bir entegrasyon, en kötü ihtimalle olayı beş dakika geç görür; webhook ise olay oluştuğu anda tetiklenir.

Webhook'un ikinci avantajı kaynak tasarrufudur. Saatte binlerce kez "yeni bir şey var mı?" diye sormak yerine, yalnızca gerçekten bir şey olduğunda bir istek almak, hem sizin sisteminizin hem platformun yükünü azaltır. Onay tamamlandığında, bir izin talebi sonuçlandığında ya da bir ihlal oluştuğunda bordro sisteminizin anında tepki vermesi gerekiyorsa, webhook'u birinci tercih olarak kurmak gerekir.

REST API ne zaman doğru seçim

API'nin güçlü olduğu yer farklıdır: toplu, dönemsel ya da geriye dönük veri ihtiyacı. Ay sonunda tüm personelin puantaj tablosunu bordro yazılımına aktarmak, yeni bir raporlama aracı kurarken geçmiş üç ayın olay verisini çekmek ya da bir denetim sırasında belirli bir tarih aralığındaki tüm kayıtları toplamak — bunların hiçbiri "olay anında" bir tetikleyici gerektirmez, tam tersine sizin kontrolünüzde, sizin belirlediğiniz zamanda çalışan bir sorgu ister.

API ayrıca webhook'un doğası gereği kaçırdığı durumları telafi eder. Sisteminiz bir nedenle kısa süre kapalıysa ya da ağ kesintisi yaşadıysa, o sırada gelen webhook bildirimleri kaybolmuş olabilir. Salt okunur bir API üzerinden aynı dönemi geriye dönük sorgulayabilmek, bu tür boşlukları kapatan bir güvenlik ağıdır. Bu yüzden olgun bir entegrasyon, webhook'u birincil kanal, API'yi ise mutabakat ve telafi kanalı olarak kurar.

Güvenlik: imzalı webhook ve token yönetimi

Her iki yöntemin de kendine özgü güvenlik gereksinimi vardır ve bunlar atlanınca entegrasyon bir denetim maddesine dönüşür. Webhook tarafında kritik soru şudur: bana gelen bu bildirim gerçekten platformdan mı geldi, yoksa biri sahte bir istek mi gönderiyor? İmzalı webhook bu soruyu çözer — her istekle birlikte gelen imza, alıcı sistemin bildirimin kaynağını doğrulamasını sağlar; imza uyuşmuyorsa istek reddedilir.

API tarafında ise erişim tokenı merkezi rol oynar. Token panelden üretilir, yalnızca ihtiyaç duyulan kapsamda çalışır ve gerektiğinde tek tıkla iptal edilir. Bir entegrasyon ortağıyla ilişki bittiğinde ya da bir token'ın sızdığından şüphelenildiğinde, bu iptalin saniyeler içinde etkili olması gerekir — token'ı üreten sistemin, kim tarafından ne zaman kullanıldığını da denetim kaydına işlemesi bu güveni tamamlar. Salt okunur olması ayrıca dış sistemin veriyi değiştirmesini de yapısal olarak engeller.

Pratik senaryo: ihlal bildirimini bordro sistemine bağlamak

Somut bir örnek üzerinden gidelim: bir güvenlik şirketi, saha dışı ihlallerini kendi bordro yazılımına otomatik olarak yansıtmak istiyor — mesai dışına çıkan personelin o günkü puantajının otomatik işaretlenmesi için. Doğru kurgu şöyle işler: webhook, ihlal oluştuğu anda bordro sistemine bir bildirim gönderir; bordro sistemi bu bildirimi alır almaz ilgili personel ve tarih için API üzerinden güncel puantaj kaydını çeker, kendi tarafında işaretler. Yalnızca webhook kurulsaydı ve bildirim bir nedenle kaybolsaydı, o gün fark edilmeyen bir boşluk kalırdı; yalnızca API kurulsaydı, ihlal ancak bir sonraki periyodik sorguda görülür, tepki gecikirdi. İkisi birlikte hem hız hem güvenilirlik sağlar.

Bu kurguyu kurarken atlanmaması gereken bir adım da mutabakattır: haftalık ya da aylık olarak, webhook'la gelen olay sayısı ile API'den çekilen olay sayısı karşılaştırılmalı. Aradaki fark, webhook tarafında kaçırılmış bir bildirim olduğuna işaret eder ve bu, denetim kaydının neden kritik olduğunu bir kez daha gösterir — sistemin kendi kaydı, entegrasyonunuzun doğru çalışıp çalışmadığını kontrol etmenin de aracıdır.

Hangi entegrasyonu seçmeli — karar checklist

Karar verirken şu soruları sırayla sormak işe yarar: Veri, oluştuğu anda mı yoksa belirli aralıklarla mı gerekli? Anında gerekiyorsa webhook birinci seçenektir. Geçmişe dönük ya da toplu veri mi lazım? O zaman API'ye yönelin. Her iki ihtiyaç da varsa — ki kurumsal entegrasyonların çoğunda böyledir — webhook'u tetikleyici, API'yi doğrulayıcı ve telafi edici katman olarak birlikte kurun. Son olarak, hangi yöntemi seçerseniz seçin, imza doğrulamasını ve token kapsamını entegrasyonun ilk gününde netleştirin; sonradan eklenen güvenlik katmanı, sisteme sonradan eklenen bir onay adımı kadar zahmetlidir.

Bordro ya da ERP tarafınıza veri aktarmak için doğru kurguyu bulmak, çoğu zaman tek bir teknik seçimden çok, hangi verinin hangi hızda hareket etmesi gerektiğini netleştirmekle başlar. HR-Tech'in saha takipli İK platformunda imzalı webhook ve salt okunur REST API bu ayrımı gözeterek birlikte sunulur; entegrasyonunuzu birlikte tasarlamak isterseniz iletişim sayfamızdan yazın.