Webhooks

Yakında — Faz 5

Webhook altyapısı Faz 5 lansmanıyla (~Q3 2026) aktif olacak. Şu an Erken Erişim kullanıcılarında kapalıdır.

Genel akış

PratikYedek belirli olaylarda HTTPS POST ile sizin endpoint'inize JSON gönderir:

POST https://your-domain.com/pratikyedek-webhook
Content-Type: application/json
X-Pratikyedek-Signature: t=1715432400,v1=abc...

{
  "event": "snapshot.completed",
  "account_id": "uuid",
  "snapshot_id": "uuid",
  "size_bytes": 8400000,
  "created_at": "2026-05-11T14:32:00Z"
}

Desteklenecek event'ler (planlanan)

• snapshot.started — Yedek başlatıldı
• snapshot.completed — Yedek tamamlandı
• snapshot.failed — Yedek başarısız
• restore.started — Restore tetiklendi
• restore.completed — Restore tamamlandı
• account.suspended — Hesap askıya alındı
• billing.charged — Ödeme alındı
• byos.token_expired — BYOS OAuth token yenilenmesi gerek

Signature doğrulama

HMAC-SHA256:

expected = HMAC-SHA256(secret, timestamp + "." + payload)

X-Pratikyedek-Signature header'ı: t=<unix>,v1=<hex>. Replay attack koruması: timestamp 5 dk dışında reddedilir.

Retry politikası

• Başarısız webhook: 1m / 5m / 30m / 2h / 6h / 1d
• 6 başarısız teslimat sonrası webhook devre dışı + e-posta uyarı
• Dashboard'dan manuel retry

Kullanım örnekleri

• Slack notify — Snapshot fail → Slack kanalına uyarı
• CRM entegrasyonu — Yeni hesap → CRM kayıt
• Muhasebe entegrasyonu — Ödeme webhook → Logo/Mikro otomatik fatura
• Monitoring — Restore drill başarısız → PagerDuty incident

Detay Faz 5 documentation'da.