YAPL'da webhook uç noktaları oluşturma ve yapılandırma adım adım kılavuzu.

Webhook Oluşturma

Bu kılavuz, YAPL çalışma alanınızdan anlık bildirimler almak için bir webhook uç noktası oluşturma sürecinde size yol gösterir.

Ön Koşullar

Çalışma alanı sahibi olmanız gerekir
Çalışma alanınız Professional veya Deneme planında olmalıdır
Webhook teslimatlarını alacak servisin URL'sine ihtiyacınız vardır

İlk Webhook'unuzu Oluşturma

Ayarlar > Webhook'lar sayfasına gidin
Webhook Oluştur düğmesine tıklayın
Uç nokta detaylarını doldurun:
- Ad — Açıklayıcı bir ad (örn. "Slack Proje Güncellemeleri")
- URL — Teslimatları alacak HTTPS uç noktası
- Açıklama — Bu webhook'un ne yaptığına dair isteğe bağlı notlar
Kaydet düğmesine tıklayın
İmzalama sırrını kopyalayın — Bu yalnızca bir kez gösterilir ve imzaları doğrulamak için gereklidir

Bir webhook oluşturduğunuzda YAPL benzersiz bir imzalama sırrı üretir. Bu sır, oluşturma işleminden hemen sonra yalnızca bir kez görüntülenir. Güvenli bir şekilde kopyalayın ve saklayın — webhook imzalarını doğrulamak için buna ihtiyacınız olacak.

Sırrınızı kaybederseniz, webhook'u silip yenisini oluşturmanız gerekir.

Uç Nokta URL Gereksinimleri

Geçerli bir HTTPS URL'si olmalıdır (HTTP yalnızca geliştirme ortamlarında izin verilir)
İnternetten herkese açık erişimli olmalıdır
10 saniye içinde yanıt vermelidir
Özel IP adresleri ve dahili ağlar güvenlik nedeniyle engellenmiştir

Olay Türlerini Yapılandırma

Varsayılan olarak yeni bir webhook tüm olayları alır. Hangi olayların teslimat tetikleyeceğini sınırlamak için:

Webhook'un düzenleme diyaloğunu açın
Almak istediğiniz belirli olay türlerini seçin
Değişikliklerinizi kaydedin

Örneğin, yalnızca proje bildirimlerini istiyorsanız, proje olaylarını seçin ve diğerlerini işaretlenmemiş bırakın. Tam liste için Olay Türleri sayfasına bakın.

Özel Başlıklar

YAPL'ın her teslimatla birlikte göndereceği özel HTTP başlıkları ekleyebilirsiniz. Bu şu durumlar için faydalıdır:

Kimlik doğrulama — Alıcı servisiniz için bir Authorization başlığı ekleyin
Yönlendirme — Altyapınız içinde teslimatları yönlendirmek için özel başlıklar ekleyin
Tanımlama — YAPL teslimatlarını diğer kaynaklardan ayırt etmek için başlıklar ekleyin

Özel başlık eklemek için:

Webhook Oluştur veya Düzenle diyaloğunu açın
Başlık Ekle düğmesine tıklayın
Başlık adı ve değerini girin
Gerektiğinde daha fazla başlık ekleyin

Webhook Düzenleme

Ayarlar > Webhook'lar sayfasına gidin
Listede uç noktayı bulun
Menü simgesine tıklayın ve Düzenle seçin
Değişikliklerinizi yapın
Kaydet düğmesine tıklayın

Adı, URL'yi, açıklamayı, olay türlerini, özel başlıkları ve aktif durumunu güncelleyebilirsiniz. İmzalama sırrı değiştirilemez — yeni bir sırra ihtiyacınız varsa yeni bir webhook oluşturun.

Etkinleştirme ve Devre Dışı Bırakma

Webhook'u silmeden teslimatları geçici olarak durdurmak için:

Webhook'u düzenleyin
Aktif anahtarını kapatın
Kaydedin

Devre dışı bırakılan webhook'lar listenizde kalır ancak teslimat almaz. Devam ettirmek için anahtarı tekrar açın.

Webhook Test Etme

Önemli bildirimler için bir webhook'a güvenmeden önce test edin:

Ayarlar > Webhook'lar sayfasına gidin
Uç noktadaki menü simgesine tıklayın
Test seçin
YAPL uç noktanıza bir test yükü gönderir
Sonucu kontrol edin — detaylarla birlikte başarı veya başarısızlık

Test teslimatı örnek bir yük kullanır ve teslimat kayıtlarında kaydedilir.

Webhook Silme

Ayarlar > Webhook'lar sayfasına gidin
Uç noktadaki menü simgesine tıklayın
Sil seçin
Silme işlemini onaylayın

Webhook silme kalıcıdır. O uç noktaya ait tüm teslimat kayıtları da kaldırılır. Webhook'a tekrar ihtiyacınız olabilecekse, silmek yerine devre dışı bırakmayı düşünün.

Slack'te bir Gelen Webhook oluşturun
Webhook URL'sini kopyalayın
Bu URL ile bir YAPL webhook'u oluşturun
Slack kanalınıza gönderilmesini istediğiniz olayları seçin

Discord Webhook

Discord'da Kanal Ayarları > Entegrasyonlar > Webhook'lar bölümüne gidin
Yeni bir webhook oluşturun ve URL'yi kopyalayın
Discord webhook URL'sine /slack ekleyin (Discord, Slack uyumlu formatı destekler)
Bu URL ile bir YAPL webhook'u oluşturun