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, arşivlendiğinde, geri yüklendiğinde veya silindiğ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

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

Görev Olayları

Yayınlanmış bir plandaki görev değiştiğinde tetiklenir. Bir planı yayınlamak, tüm değişiklikleri listeleyen tek bir plan.published.v1 gönderir; o yayının görev bazındaki olayları ayrıca gönderilmez.

Olay Türü	Açıklama
`plan.task.updated.v1`	Bir görevin detayları değiştirildi
`plan.task.status.changed.v1`	Bir görevin durumu değişti (örn. Başlamadı'dan Devam Ediyor'a)
`plan.task.assigned.v1`	Bir göreve kişi atandı
`plan.task.unassigned.v1`	Bir görevden kişi ataması kaldırıldı

Çalışma Alanı Olayları

Çalışma alanının sahipleri değiştiğinde tetiklenir.

Olay Türü	Açıklama
`workspace.owner-added.v1`	Biri çalışma alanı sahipliği davetini kabul etti. Yük, kişinin e-posta adresini içerir.

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 olayları alacağını seçin:

Tüm etkinlikler (varsayılan) — Uç nokta bu sayfadaki her olayı alır, ileride eklenecek olay türleri dahil
Belirli olaylar — Tüm etkinlikler anahtarını kapatın ve entegrasyonunuzun ihtiyaç duyduğu olayları işaretleyin

Örneğin, proje güncellemeleri için bir Slack kanalı yalnızca project.created.v1, project.archived.v1 ve plan.published.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ı

Adlar ve kullanıcı kimlikleri yüke dahildir. workspace.owner-added.v1 ayrıca yeni sahibin e-posta adresini taşır.

İ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

On this page