Webhook'lar

Webhook'lar, çalışma alanınızdaki olayları saniyeler içinde sizin belirlediğiniz bir HTTPS uç noktasına iletir.

Abonelik oluşturma

Ayarlar → Uygulamalar → Webhook'lar → Yeni webhook (ya da webhooks:manage scope'uyla POST /webhooks) ile şunları verin:

• URL — https:// olmalı, 443 ya da 8443 portu; özel ağ adresine çözümlenmemeli.
• Olaylar — olay kataloğundan istediğiniz alt küme.
• Board'lar — isteğe bağlı filtre; boş = tüm board'lar.

Yanıtta imza secret'ı (whsec_…) yalnız bir kez gelir. Saklayın; imza doğrulama için gerekir.

Teslimat

Her olay JSON gövdeli POST olarak gelir:

{
  "id": "66dc0a3f8e9b4c1234567890",
  "type": "ticket.state_changed",
  "occurredAt": "2026-09-07T12:05:00Z",
  "workspace": "https://acme.stoneity.com",
  "actor": { "id": 17, "name": "Ayşe Yılmaz" },
  "changes": { "field": "Durum", "oldValue": "Açık", "newValue": "İşlemde" },
  "data": { "...kayıt temsili..." }
}

Başlıklar:

Başlık	Değer
webhook-id	Olay id'si (idempotency anahtarı olarak kullanın)
webhook-timestamp	Gönderim anı, Unix saniye
webhook-signature	v1,<base64 HMAC-SHA256> — bkz. İmza doğrulama
Content-Type	application/json
User-Agent	Stoneity-Webhooks/1.0

10 saniye içinde herhangi bir 2xx dönün. Asıl işi arka planda yapın.

Yeniden deneme

Teslimat en az bir kezdir. 2xx olmayan yanıt ya da zaman aşımı 1 dk, 5 dk, 30 dk, 2 sa, 8 sa ve 24 sa sonra yeniden denenir (toplam 7 deneme). Denemeler aynı webhook-id'yi taşır; buna göre tekilleştirin.

• 410 Gone aboneliği anında kapatır.
• 20 ardışık başarısız teslimat aboneliği duraklatır ve çalışma alanı yöneticilerine bildirim gönderir. Uç noktanız düzelince ayarlar sayfasından sürdürün.

Teslimat logu

Her deneme 30 gün boyunca aboneliğin Teslimatlar panelinde (durum, HTTP kodu, süre, yanıt özeti, gövde) ve GET /webhooks/{id}/deliveries ile görülebilir. Her teslimat aynı gövdeyle yeniden gönderilebilir.

Secret yenileme

Secret yenile yeni bir whsec_… üretir. 24 saat boyunca teslimatlar hem yeni hem eski secret ile imzalanır (boşlukla ayrılmış iki imza); kesintisiz geçiş yapabilirsiniz.

Test

Abonelikteki Test, gerçek trafik gelmeden bağlantıyı ve imza doğrulamasını denemeniz için bir webhook.test olayı kuyruğa alır.