Entegrasyonlar

Hattınıza bağlayın. Kanıtı taşıyın.

API anahtarları, tarama tetikleyicileri, dağıtım webhookları ve giden webhooklar. Crawlens’i teslimat hattınıza bağlayın.

WebhooksAPI AnahtarlarıDeploy Webhooks
API

Operasyon İçin Net Entegrasyon Yüzeyleri

Mevcut CI/CD hattınızdan görsel kontrolleri 5 dakikadan kısa sürede kopyalayın, yapıştırın ve tetikleyin.

01

Webhooks

Taramalar tamamlandığında gerçek zamanlı bildirimler alın. Yükler değişiklik tespiti sonuçlarını, görsel farkları ve snapshot meta verilerini içerir.

02

API Anahtarları

Ayrıntılı izinlere sahip kapsamlı API anahtarları oluşturun. RESTful API’miz üzerinden taramaları tetikleyin.

03

Deploy Webhooks

Her dağıtımdan sonra görsel taramaları otomatik olarak tetiklemek için Vercel veya Netlify webhook’larını bağlayın.

webhook-payload.json
{
  "event": "crawl.success",
  "timestamp": "2026-01-15T10:30:00Z",
  "url_id": "67d0f9ab12cd34ef56a7b890",
  "url": "https://example.com/checkout",
  "snapshot_id": "67d0f9ab12cd34ef56a7b891"
}
scan-trigger.sh
curl -X POST "$API_BASE/api/projects/$PROJECT_ID/scan" \
  -H "Authorization: Bearer $CRAWLENS_API_KEY" \
  -H "X-Org-ID: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"triggered_by":"ci"}'
PLAN FARKINDALIKLI ENTEGRASYON ERİŞİMİ

Entegrasyonlar organizasyon bazlıdır. Limitler ve gelişmiş kontroller planla birlikte uygulanır; ekipler kapasiteyi güvenli şekilde ölçekler.

FREE

Webhook ve alert kuralı Free planda kapalıdır; API dokümantasyonu ve kurulum referansları açıktır.

PRO

2 adede kadar webhook ve 10 alert kuralı; CI/CD tetiklemeli taramalar ve bildirim yönlendirmesi dahil.

AGENCY

Site portföyü için webhook ve uyarı kapasitesi (25 webhook / high-capacity uyarı kuralı), daha uzun kanıt geçmişi ve daha fazla koltuk.

Webhook

Gerçek API Örnekleri

Bu bölüm, backend kodunda aktif olan route ve delivery davranışıyla birebir eşleşir.

deployment-webhook.sh
curl -X POST "$API_BASE/api/projects/$PROJECT_ID/deployments" \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Secret: $WEBHOOK_SECRET" \
  -d '{
    "version":"v1.4.2",
    "author":"release-bot",
    "commit_msg":"checkout css fixes",
    "commit_sha":"1a2b3c4d",
    "environment":"production"
  }'
webhook-register.sh
curl -X POST "$API_BASE/api/webhooks" \
  -H "Authorization: Bearer $CRAWLENS_API_KEY" \
  -H "X-Org-ID: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "provider":"custom",
    "url":"https://hooks.example.com/crawlens",
    "events":["crawl.success","crawl.failed"],
    "secret":"whsec_prod_123",
    "headers":{"X-Env":"production"}
  }'
inbound-webhook-trigger.sh
curl -X POST "$API_BASE/api/webhook/trigger" \
  -H "Content-Type: application/json" \
  -H "X-Hub-Signature-256: sha256=<hmac_signature>" \
  -d '{"project_id":"$PROJECT_ID"}'
Desteklenen outbound webhook event’leri
  • crawl.success — crawl işlemi başarıyla tamamlandığında gönderilir
  • crawl.failed — crawl işlemi hata aldığında gönderilir
  • alert.rule_triggered — alert rule tetiklendiğinde gönderilir
Delivery header’ları
X-Webhook-Event: <event_name>
X-Webhook-Delivery: <delivery_id>
X-Webhook-Idempotency-Key: <event:id>
X-Webhook-Signature: sha256=<hmac>   # only when secret is set
Güvenlik ve teslimat garantileri
  • İmzalı teslimat: secret tanımlıysa X-Webhook-Signature (HMAC SHA-256).
  • Inbound koruma: trigger endpoint için X-Hub-Signature-256 doğrulaması, deploy endpoint için opsiyonel X-Webhook-Secret.
  • Backoff ile asenkron retry, redrive endpoint desteği ve olay müdahalesi için delivery logları.
Uç noktalar

Doğrulanmış webhook mimarisi

Teslimat davranışı operasyonel güvenilirlik ve izlenebilirlik için tasarlanmıştır.

01

Outbound webhooklar (org bazlı)

Outbound abonelikleri oluşturun/yönetin, delivery geçmişini izleyin. Organizasyon planına göre sınırlandırılır.

POST /api/webhooks
GET /api/webhooks
PATCH /api/webhooks/{id}
DELETE /api/webhooks/{id}
GET /api/webhooks/{id}/deliveries
GET /api/webhooks/stats
POST /api/webhooks/{id}/deliveries/{delivery_id}/redrive
02

İçe dönük tarama tetikleyici

İmzalı gelen webhook çağrılarını kabul edin ve harici sistemlerden taramalar başlatın.

POST /api/webhook/trigger
GET /api/webhook/status/{task_id}
03

Deployment marker webhook

Release pencerelerini görsel/performance değişimleriyle eşlemek için deployment eventlerini kaydeder.

POST /api/projects/{project_id}/deployments
04

Operasyonel kanıt paneli

Olay anlarında ops ekiplerinin kullanabileceği webhook stats ve redrive akışlarının somut çıktıları.

Teslimat istatistikleri · webhook-stats-response.json
{
  "window_hours": 24,
  "totals": {
    "pending": 2,
    "success": 183,
    "failed": 7,
    "completed": 190
  },
  "success_rate": 0.9632,
  "p95_delivery_latency_ms": 842.5,
  "avg_attempts": 1.18,
  "retry_ratio": 0.091
}
Yeniden gönderim · webhook-redrive.sh
curl -X POST "$API_BASE/api/webhooks/$WEBHOOK_ID/deliveries/$DELIVERY_ID/redrive" \
  -H "Authorization: Bearer $CRAWLENS_API_KEY" \
  -H "X-Org-ID: $ORG_ID"
Katalog

Entegrasyon Kapsamı

Araç bazlı mevcut kapsam. GA = bugün doğrudan destek, Yakında = roadmap.

GA

GitHub Actions

CI/CD sürecinden tarama tetikleyin.

GA

GitLab CI

GitLab pipeline’larından API/webhook ile taramaları tetikleyin.

GA

Jenkins

Tarama tetikleme API’si ile derleme sonrası görsel kontroller.

GA

CircleCI

CircleCI’da API/webhook ile görsel test çalıştırın.

GA

Slack

Slack webhook kanalı ile alarm teslimi.

GA

Vercel

Dağıtımda otomatik tarama.

GA

Netlify

Dağıtım webhook görsel tarama tetikler.

Yakında

Discord

Discord için provider-adapter desteği planlanıyor.

Yakında

PagerDuty

Özel PagerDuty connector planlanıyor.

GA — GA entegrasyonları bugün doğrudan API/tarama/dağıtım endpointleri ile desteklenmektedir.Yakında — Yakında etiketliler roadmap görünürlüğü içindir; generic webhook/API kullanımından native seviyeye taşınacaktır.

Kanıtı taşıyın.

API anahtarları, tarama tetikleyicileri, dağıtım webhookları ve giden webhooklar. Crawlens’i teslimat hattınıza bağlayın.

Destek alın ↗