Entegrasyonlar

Operasyon İçin Net Entegrasyon Yüzeyleri

API anahtarları, workflow trigger, deployment webhook ve outbound webhook ile pipeline'ınıza bağlanın. Native adapter iddiası olmayan gerçek kapsam.

Webhooks

Taramalar tamamlandığında gerçek zamanlı bildirimler alın. Akıllı Gruplandırma, Web Vitals ve sağlık skorları dahil.

API Anahtarları

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

Deploy Webhooks

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

API Dokümanlarını Görüntüle

webhook-payload.json

{
  "event": "crawl.success",
  "timestamp": "2026-01-15T10:30:00Z",
  "url_id": "67d0f9ab12cd34ef56a7b890",
  "url": "https://example.com/checkout",
  "snapshot_id": "67d0f9ab12cd34ef56a7b891"
}

Plan farkındalıklı entegrasyon erişimi

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

Starter

API dokümantasyonu ve temel kurulum referansları vardır. Outbound webhook ve alert rule açık değildir.

Pro

CI/CD tetikli iş akışları ve bildirim yönlendirmesi dahil 5 webhook ve 10 alert rule desteği.

Enterprise

Webhook ve alert policy kapasitesi (high-capacity webhook / high-capacity alert rule), özel entegrasyon desteği ve yönetişim uyumlu rollout kontrolleri.

CI/CD

Gerçek API Örnekleri

Sadece 5 dakikada CI/CD iş akışınızdan kopyalayın, yapıştırın ve görsel testleri tetikleyin.

workflow-trigger.sh

curl -X POST "$API_BASE/api/workflows/$WORKFLOW_ID/trigger" \
  -H "Authorization: Bearer $CRAWLENS_API_KEY" \
  -H "X-Org-ID: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"triggered_by":"webhook"}'

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"}
  }'

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

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"}'

Doğrulanmış webhook mimarisi

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

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

Inbound workflow tetikleme

İmzalı inbound webhook çağrılarını kabul eder ve dış sistemlerden scan/workflow başlatır.

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

Deployment marker webhook

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

POST /api/projects/{project_id}/deployments

Güvenlik ve teslimat garantileri

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

İ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ı.

GA GA entegrasyonlar bugün API/workflow/deployment endpointleriyle doğrudan desteklenir.

Yakında Yakında etiketliler roadmap görünürlüğü içindir; generic webhook/API kullanımından native seviyeye taşınacaktır.

Operasyonel kanıt paneli

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

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
}

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"