Webhook’lar

Webhook'lar, PeekHire'da bir şey olduğunda kontrol ettiğiniz bir URL'ye küçük bir mesaj gönderir; böylece API'yi yoklamak yerine gerçek zamanlı tepki verebilirsiniz.

Webhook'lar nasıl çalışır?

1. Geliştirici araçları → Webhook'lar altında bir uç nokta (sunucunuzdaki bir URL veya otomasyon aracı) oluşturursunuz.
2. Hangi etkinlikleri alacağını seçersiniz.
3. Bir etkinlik gerçekleştiğinde PeekHire, uç noktanıza JSON veri yüküyle bir HTTP POST gönderir.

Veri yükleri özellikle küçük tutulur — ne olduğunu ve hangi nesneyle ilgili olduğunu belirtir; gerekirse tüm ayrıntıları REST API üzerinden alabilirsiniz.

Kullanılabilir etkinlikler

Etkinlikler işe alım yaşam döngüsünü kapsar, örneğin:

• Başvurular — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Başvuru yorumları — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampanyalar — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Teslimatları doğrulama

Her teslimat imzalanır; böylece gerçekten PeekHire'dan geldiğini doğrulayabilirsiniz. Veri yüküne güvenmeden önce uç noktanızda imzayı doğrulayın ve alındığını onaylamak için 2xx durumuyla yanıt verin.

Teslimatları inceleme

Teslimatlar görünümü son webhook denemelerini ve sonuçlarını gösterir; böylece etkinliklerin ulaştığını doğrulayabilir ve yanıt vermeyen bir uç noktada hata ayıklayabilirsiniz.

İpuçları

• Hızlıca bir 2xx ile yanıt verin ve ağır işleri asenkron olarak yürütün.
• İşleyicinizi idempotent olacak şekilde tasarlayın — aynı etkinlik zaman zaman birden fazla kez teslim edilebilir.
• Sunucu çalıştırmak istemiyorsanız Make, Zapier veya n8n gibi bir araçla başlayın.