Entegrasyonlar

Kimler için

• CI/CD hattı olan ekipler
• Bildirimleri Slack veya kendi panellerine taşımak isteyenler
• Kanıtı müşteriye düzenli olarak gönderen hesap yöneticileri

Ön koşullar

• İzlemeye alınmış URL’ler
• Token’ı saklayabileceğiniz bir CI secret alanı

Adım adım

1. Tetikleme token’ı oluşturun

   Token’lar clt_ önekiyle üretilir, yalnızca oluşturulduğu anda tam haliyle gösterilir ve sunucuda hash’lenmiş olarak saklanır.

2. Kapsamı daraltın

   Token proje veya tek URL kapsamında olur. Yetkisi yalnızca tarama başlatmaktır; veri okumaz, ayar değiştirmez. Genel bir API anahtarı değildir.

3. Deploy sonrası çağırın

   Deploy adımınızın sonuna tetikleme isteğini ekleyin. Tarama kuyruğa girer, sonuç normal akışta değerlendirilir.

4. Yayın öncesi/sonrası kontrol

   Tek bir taramadan fazlasını istiyorsanız: yayından önce POST /api/deploy-checks (proje id ve isteğe bağlı bir etiketle) “öncesi”ni çeker; yayını yaptıktan sonra POST /api/deploy-checks/{id}/after “sonrası”nı çeker. GET /api/deploy-checks/{id} ile rapor alınır — yakalamalar bitince durum completed olur. Baseline ilerlemez; bu, izlemeden ayrı bir karşılaştırmadır.

5. Token’ı iptal edin

   Sızdığından şüphelendiğinizde veya müşteriyle yollar ayrıldığında token iptal edilir ve anında geçersiz olur.

6. Giden webhook ve paylaşım

   Değişiklik olaylarını kendi uç noktanıza gönderin. Kanıtı müşteriyle paylaşmak için süreli paylaşım linki oluşturun: varsayılan 7 gün, 1–30 gün arası, her zaman iptal edilebilir.

Operasyonel çıktılar

• Deploy’a bağlı tarama kayıtları
• Kendi sisteminize akan değişiklik olayları
• Müşteriye gönderilebilir süreli kanıt linkleri
• Yayın başına tek bir öncesi/sonrası raporu

Plan uygunluğu

• Tetikleme token’ları Pro ve Agency planlarında
• Webhook sayısı: Free 0, Pro 2, Agency 10
• Paylaşım linkleri tüm ücretli planlarda

Limitler ve guardrail’ler

• Token yalnızca tarama başlatır; başka hiçbir yetkisi yoktur
• Tetiklenen taramalar günlük tetikleme kotasını tüketir
• Paylaşım linki yalnızca ekran görüntüsü, diff, tarih, URL ve değişiklik özetini açar; HTML arşivini veya organizasyon verisini açmaz
• İptal edilmiş veya süresi geçmiş link sessizce 404 döner
• Hazır Slack/Jira uygulaması yok; bağlantı webhook üzerinden kurulur
• Yayın kontrolü aynı proje token’ıyla çalışır; başka projede kontrol açamaz
• “Sonrası” çekimi sırasında o URL için zaten çalışan bir tarama varsa devralınmaz ve tekrar çalıştırmanız istenir — deploy’dan önce başlamış bir çekim yayını kendisiyle karşılaştırırdı

Beklenen sonuç

• Deploy ile tarama arasındaki gecikmenin kapanması
• Bildirimlerin ekibin zaten baktığı yere düşmesi
• Kanıtın müşteriye hesap açmadan ulaşması

Sorun giderme yolları

• Tetikleme 401 dönüyorsa token iptal edilmiş veya yanlış kopyalanmış olabilir
• Tetikleme 403 dönüyorsa token’ın kapsamı o URL’yi içermiyordur
• Tetikleme 402 dönüyorsa günlük tetikleme kotası dolmuştur