Webhook Olay Türleri

YAPL projeler, ekipler, planlar ve çalışma alanları genelindeki olaylar için webhook bildirimleri gönderebilir. Bu sayfa, her kullanılabilir olay türünü ne zaman tetiklendiğine dair bir açıklama ile listeler.

Olay Türü Formatı

Olay türleri alan.eylem.sürüm kalıbını izler:

project.created.v1
│       │       │
│       │       └── Sürüm (gelecek uyumluluk için)
│       └────────── Ne oldu
└────────────────── Hangi alan

Proje Olayları

Projeler oluşturulduğunda, güncellendiğinde veya durum değiştirdiğinde tetiklenir.

Olay Türü	Açıklama
`project.created.v1`	Yeni bir proje oluşturuldu
`project.updated.v1`	Bir projenin detayları değiştirildi (ad, açıklama, tarihler, bütçe)
`project.deleted.v1`	Bir proje kalıcı olarak silindi
`project.archived.v1`	Bir proje arşive taşındı
`project.restored.v1`	Arşivlenmiş bir proje aktif duruma geri yüklendi
`project.statusChanged.v1`	Bir projenin durumu değişti (örn. Planlama'dan Aktif'e, Aktif'ten Beklemede'ye)

Ekip Olayları

Ekipler veya ekip üyeliği değiştiğinde tetiklenir.

Olay Türü	Açıklama
`team.created.v1`	Yeni bir ekip oluşturuldu
`team.updated.v1`	Bir ekibin detayları değiştirildi (ad, açıklama)
`team.deleted.v1`	Bir ekip silindi
`team.member-added.v1`	Bir ekibe üye eklendi
`team.member-removed.v1`	Bir ekipten üye çıkarıldı
`team.member-role-changed.v1`	Bir ekip üyesinin rolü değiştirildi (örn. Üye'den Lider'e)

Plan Olayları

Planlar (projeler içindeki zamanlama dokümanları) değiştirildiğinde tetiklenir.

Olay Türü	Açıklama
`plan.created.v1`	Yeni bir plan oluşturuldu
`plan.published.v1`	Bir plan yayınlandı (ekibe görünür hale getirildi)
`plan.archived.v1`	Bir plan arşivlendi
`plan.restored.v1`	Arşivlenmiş bir plan geri yüklendi
`plan.deleted.v1`	Bir plan kalıcı olarak silindi
`plan.task.added.v1`	Bir plana yeni bir görev eklendi
`plan.task.updated.v1`	Bir plan içindeki görev güncellendi
`plan.task.deleted.v1`	Bir plandan görev çıkarıldı

Çalışma Alanı Olayları

Çalışma alanı düzeyinde ayarlar değiştiğinde tetiklenir.

Olay Türü	Açıklama
`workspace.updated.v1`	Çalışma alanı ayarları değiştirildi (ad, açıklama, yapılandırma)

Olay Yükü Örnekleri

Proje Oluşturuldu

{
  "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",
    "teamId": "team_321",
    "teamName": "Operasyon",
    "actorName": "Ahmet Yılmaz"
  }
}

Ekibe Üye Eklendi

{
  "id": "evt_def456",
  "type": "team.member-added.v1",
  "timestamp": "2026-03-25T11:00:00.000Z",
  "workspaceId": "ws_xyz789",
  "data": {
    "teamId": "team_321",
    "teamName": "Mühendislik",
    "memberId": "user_890",
    "memberName": "Ayşe Demir",
    "role": "member",
    "actorName": "Ahmet Yılmaz"
  }
}

Görev Güncellendi

{
  "id": "evt_ghi789",
  "type": "plan.task.updated.v1",
  "timestamp": "2026-03-25T14:15:00.000Z",
  "workspaceId": "ws_xyz789",
  "data": {
    "planId": "plan_555",
    "planName": "Q2 Programı",
    "taskId": "task_777",
    "taskName": "Temel Çalışması",
    "actorName": "Ayşe Demir"
  }
}

Olayları Filtreleme

Bir webhook uç noktası oluştururken veya düzenlerken hangi olay türlerini alacağını seçebilirsiniz:

Tüm olaylar — Her şeyi almak için olay türlerini boş bırakın (varsayılan)
Belirli olaylar — Yalnızca entegrasyonunuzla ilgili olayları seçin

Örneğin, proje güncellemeleri için bir Slack kanalı yalnızca project.created.v1, project.statusChanged.v1 ve project.archived.v1 olaylarına abone olabilir.

Veri Hassasiyeti

YAPL, teslimat öncesinde webhook yüklerinden hassas alanları otomatik olarak çıkarır. Aşağıdaki alanlar asla dahil edilmez:

Şifreler ve şifre hash'leri
Erişim tokenları ve yenileme tokenları
API anahtarları ve sırlar
Oturum tanımlayıcıları
IP adresleri ve kullanıcı ajanları

İlgili Konular

Webhook Oluşturma — Uç noktaları oluşturun
Teslimat Kayıtları — Teslimat durumunu izleyin
İmza Doğrulama — Uç noktanızı güvence altına alın

Bu sayfa yardımcı oldu mu?

Olay Türleri

Bu Sayfada