Webhook'lar
Webhook bildirimleri ile YAPL'ı harici araçlara ve servislere bağlayın.
Webhook'lar
Webhook'lar, çalışma alanınızda bir şey değiştiğinde YAPL'ın harici servislere anlık bildirim göndermesini sağlar. Bir proje oluşturulduğunda, bir görev güncellendiğinde veya bir ekip üyesi eklendiğinde, YAPL Slack, Discord, Zapier, Make, n8n veya kendi özel servisleriniz gibi araçları anında bilgilendirebilir.
Webhook'lar Nasıl Çalışır
Çalışma alanınızda bir olay gerçekleştiğinde YAPL:
- Hangi webhook uç noktalarının o olay türü için yapılandırıldığını kontrol eder
- Olay detaylarını içeren bir JSON yükü oluşturur
- Eşleşen her uç noktaya bir HTTP POST isteği gönderir
- Teslimat sonucunu (başarılı veya başarısız) kaydeder
- Başarısız teslimatları otomatik olarak yeniden dener
Webhook'larla Neler Yapabilirsiniz
- Slack/Discord bildirimleri — Proje durumu değiştiğinde ekip kanalınızda mesaj alın
- Otomasyon platformları — YAPL olaylarından Zapier, Make veya n8n iş akışları tetikleyin
- Özel panolar — Proje güncellemelerini dahili araçlarınıza aktarın
- Denetim kayıtları — Olay verilerini harici kayıt servislerine gönderin
- E-posta uyarıları — SendGrid veya Mailgun gibi servisler üzerinden e-posta bildirimleri tetikleyin
Kullanılabilirlik
Webhook'lar Professional ve Deneme planlarında kullanılabilir. Her çalışma alanı en fazla 10 webhook uç noktasına sahip olabilir.
| Plan | Webhook'lar |
|---|---|
| Deneme | 10 uç noktaya kadar |
| Basic | Kullanılamaz |
| Professional | 10 uç noktaya kadar |
Basic planındaysanız, mevcut webhook'ları görüntüleyebilir ve silebilirsiniz ancak yeni oluşturamaz veya mevcutları düzenleyemezsiniz. Webhook'ları etkinleştirmek için planınızı yükseltin.
Bu Bölümde
Kurulum
- Webhook Oluşturma — Webhook uç noktaları oluşturun ve yapılandırın
Referans
- Olay Türleri — Webhook teslimatlarını tetikleyebilecek tüm olaylar
İzleme
- Teslimat Kayıtları — Teslimat durumunu takip edin ve sorunları giderin
Güvenlik
- İmza Doğrulama — Teslimatların YAPL'dan geldiğini doğrulayın
Hızlı Referans
| Görev | Konum |
|---|---|
| Webhook oluştur | Ayarlar > Webhook'lar > Webhook Oluştur |
| Webhook düzenle | Ayarlar > Webhook'lar > [Uç Nokta] > Düzenle |
| Webhook sil | Ayarlar > Webhook'lar > [Uç Nokta] > Sil |
| Webhook test et | Ayarlar > Webhook'lar > [Uç Nokta] > Test |
| Teslimat kayıtlarını gör | Ayarlar > Webhook'lar > [Uç Nokta] > Teslimatlar |
Webhook Yükü Formatı
Her webhook teslimatı şu yapıda bir JSON yükü gönderir:
{
"id": "evt_abc123",
"type": "project.created.v1",
"timestamp": "2026-03-25T10:30:00.000Z",
"workspaceId": "ws_xyz789",
"data": {
"projectId": "proj_456",
"projectName": "Ofis Renovasyonu",
"status": "planning"
}
}| Alan | Açıklama |
|---|---|
id | Benzersiz olay tanımlayıcısı |
type | Olay türü (bkz. Olay Türleri) |
timestamp | Olayın gerçekleştiği zaman (ISO 8601) |
workspaceId | Çalışma alanı tanımlayıcınız |
data | Olaya özgü detaylar |
Güvenlik
Her teslimat, X-YAPL-Signature-256 başlığında bir HMAC-SHA256 imzası içerir. Alıcı servisiniz, isteğin YAPL'dan geldiğini doğrulamak için bu imzayı kontrol etmelidir. Uygulama detayları için İmza Doğrulama sayfasına bakın.
Hassas bilgiler (şifreler, tokenlar, API anahtarları) teslimat öncesinde yüklerden otomatik olarak çıkarılır.
Yeniden Deneme Politikası
Bir teslimat başarısız olursa (ağ hatası veya 2xx olmayan yanıt), YAPL otomatik olarak yeniden dener:
| Deneme | Gecikme |
|---|---|
| 1. yeniden deneme | 30 saniye |
| 2. yeniden deneme | 2 dakika |
| 3. yeniden deneme | 10 dakika |
| 4. yeniden deneme | 1 saat |
| 5. yeniden deneme | 6 saat |
5 başarısız denemeden sonra teslimat başarısız olarak işaretlenir. Tüm teslimat denemelerini Teslimat Kayıtları'nda görüntüleyebilirsiniz.
İlgili Konular
- Abonelik Planları — Plan karşılaştırması ve özellik kullanılabilirliği
- Plan Yükseltme — Yükselterek webhook'ları etkinleştirin
- Çalışma Alanı Ayarları — Diğer çalışma alanı yapılandırması
Bu sayfa yardımcı oldu mu?