Proje bildirimlerini alın

Alıcı oluşturun

Erişim açıldığında Ayarlar → Entegrasyonlar bölümüne herkese açık HTTPS alıcısı ekleyin, olayları seçin ve bir kez gösterilen imza sırrını kaydedin. webhooks:manage anahtarıyla da oluşturabilirsiniz:

curl --fail-with-body https://api.captionbolt.com/v1/webhooks \
  -H "Authorization: Bearer $CAPTIONBOLT_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://receiver.example/captionbolt","events":["project.completed","project.failed"]}'

URL’yi gerçek alıcınızla değiştirin. Yalnız herkese açık HTTPS ve 443 portu desteklenir; yönlendirmeler izlenmez. Localhost ve özel ağlar doğrudan teslimat alamaz.

Olayları seçin

project.completed: dışa aktarma bitti; varsayılan abonelik.
project.failed: işleme veya dışa aktarma başarısız; varsayılan abonelik.
project.ready: tam işleme bitti, incelemeye veya dışa aktarmaya hazır.
project.cancelled: proje iptal edildi.

Ana uygulama, REST veya MCP ile oluşturulan uygun hesap videoları kapsanır. Bağımsız Transcripts, silinen veya erişimi dolan projeler hariçtir. Ready, insan tarafından incelendiğini doğrulamaz.

{
  "id": "event-uuid",
  "type": "project.completed",
  "createdAt": "2026-09-10T12:00:00.000Z",
  "data": {
    "projectId": "project-uuid",
    "status": "completed",
    "stage": "export",
    "resultUrl": "https://api.captionbolt.com/v1/projects/project-uuid/result"
  }
}

data.resultUrl, video dosyası değil, kimlik doğrulamalı API adresidir. Güncel indirme bağlantıları için okuma izinli API Key’inizi kullanın. Olaylar yalnız meta veri içerir; video veya altyazı metni içermez.

İşlemeden önce doğrulayın

Biçim Standard Webhooks standardını izler. Uyumlu doğrulayıcı veya şu kontrolleri kullanın:

Ham gövdeyi koruyun; webhook-id, webhook-timestamp, webhook-signature okuyun.
whsec_ önekini kaldırıp sırrı base64 çözün. id.timestamp.rawBody üzerinde HMAC-SHA256 hesaplayın; base64 imzayı sabit zamanda karşılaştırın.
Beş dakika gibi sınırlı tolerans dışındaki geçmiş ve gelecek zamanları reddedin. Anahtar yenilenirken boşlukla ayrılmış birden çok v1, imzası olabilir; güvenilen anahtarla eşleşeni kabul edin.
Olay kimliğiyle tekrarları ayıklayın ve 2xx yanıtından önce işi kalıcı kaydedin. İşlemi asenkron yapın; 15 saniyelik sınır içinde hızlıca onaylayın.

İmza sırrı API Key’den ayrıdır. Yenileme yeni sırrı bir kez gösterir ve 24 saat örtüşme sağlar. Bu sürede tekrar yenileme engellenir.

Teslimatları test edin ve kurtarın

Ayarlardaki test webhook.test gönderir; ayrı işleyin. Son 30 günlük geçmişi kontrol edin, alıcı hatalarını düzeltin ve başarısız veya önceden teslim edilmiş olayı elle tekrar gönderin.

Olaylar tekrarlanabilir veya sırasız gelebilir. 2xx dışı yanıtlar, bağlantı hataları veya eksik onaylar için toplam üç otomatik deneme yapılır: ilk istek, ardından yaklaşık bir ve beş dakika sonraki iki deneme. Üçüncü hata otomatik teslimatı durdurur. Elle yeniden deneme olay kimliğini korur ve üç denemelik hakkı yeniler; alıcı idempotent olmalıdır.

Devre dışı bırakma bekleyenleri durdurur; devam eden istek bitebilir. Alıcıyı silmek geçmişi de siler. Proje silinmesi veya erişim bitişi bekleyen bildirimlerini durdurur. Webhooks medya erişimini uzatmaz; sonuçları zamanında saklayın veya proje durumunu sorgulayın.