API-Referenz

# Schnellstart

API-Key unter Einstellungen > API-Keys erstellen. Der Key beginnt mit xtraq_ und wird nur einmal angezeigt.

$ curl -H "Authorization: Bearer xtraq_IHR_KEY" \
       https://api.xictraq.com/api/websites

[{"id":"019d7e3c-...","name":"Shop","url":"https://shop.invalid","is_up":true}]

# Vollständige Endpoint-Referenz

Live aus der OpenAPI-Spezifikation generiert — immer aktuell. Die ausführlichen Beispiele weiter unten decken die häufigsten Endpoints ab.

Lädt …

# Plan-Limits

# Websites

# Scans

# Uptime & SSL

# Alerts

# Analytics (Starter+)

# E-Commerce & Shopdaten (Business)

Umsatz, Bestellungen, Produkte und die Daten aus dem Shopware-6-Bestellimport. Die Auswertungen und Shopdaten-Endpunkte verlangen den Business-Tarif; die Shop-Anbindung selbst (shop-integration) nicht, dort nur das Einschalten des Bestellimports. Alle Endpunkte lassen sich mit einem API-Key nutzen, schreibende nur mit Schreibrecht des Keys. Beträge mit der Endung _minor stehen in Cent. Bestellungen aus dem Import ohne Tracker-Kauf zählen in Umsatz, Bestellungen, Produkten und Export mit, nicht in Conversion, Funnel und ROAS. Name, Firma und Kundennummer aus dem Import erscheinen nur mit Kundenzuordnung im Tarif und nie bei neutralisiertem Abruf. Über Freigabelinks kommen nie Kundendaten, weder aus dem Import noch Identitäten des Trackers (Name, Firma, Kunden-ID, external_user_id); die Kennzahlen bleiben.

# Heartbeats

# API-Monitoring (Starter+)

# API-Keys (Business+, Geo-Key in jedem Tarif)

# Neutralisierte Abrufe (DSGVO)

Jeder Endpunkt kann seine Antwort ohne Personendaten ausliefern: Namen, E-Mail-Adressen und Rufnummern fallen weg, alle übrigen Felder bleiben unverändert. Gedacht für die Weiterverarbeitung im Data-Warehouse, im BI-Werkzeug oder bei einem Dienstleister, der die Personendaten nicht braucht.

[
  {
    "id": "019d8f2a-…",
    "email": "team@firma.invalid",
    "role": "editor",
    "status": "accepted",
    "created_at": "2026-06-14T09:12:00Z"
  }
]

[
  {
    "id": "019d8f2a-…",
    "email": null,
    "role": "editor",
    "status": "accepted",
    "created_at": "2026-06-14T09:12:00Z"
  }
]

# Geo-API (Add-on)

Native, offline IP-Geolokation direkt aus eigenen Indizes — DSGVO-konform, ohne Live-Anfrage an Dritte. Daten stammen aus offenen Quellen. Die Geo-API ist ein Add-on zu jedem Tarif — auch zum Gratis-Tarif — und wird in drei Volumen-Stufen gebucht: Starter (50.000 Lookups/Monat), Pro (500.000) und Business (3 Mio.). Ohne gebuchtes Add-on sind zum Testen 1.000 Lookups pro Monat inklusive.

# Rechnungen

# Empfehlungsprogramm

# USt-ID (VIES)

# Account

# Status-Pages (in jedem Tarif)

# Team & Agency

Team-Mitglieder einladen (ab Starter), Client-Portal verwalten (Agency), Agency-Zugriff gewähren (in jedem Tarif).

# Browser-Monitore (Business+)

Playwright-basierte Multi-Step-Skripte: Login-Flows, Checkout, Formulare automatisiert prüfen.

# Reports & Vorlagen (Business+)

Automatisierte Reports erstellen, planen und an Empfänger senden.

# Webhooks (Business+)

JSON-POST bei jedem Alert. Events: alert.opened, alert.resolved. HMAC-SHA256-Signatur.

POST https://hooks.firma.invalid/xictraq
X-Xictraq-Event: alert.opened
X-Xictraq-Delivery: dlv_8f3a91c2d4e6f0a1
X-Xictraq-Signature: sha256=8f3a91...

{
  "event": "alert.opened",
  "delivered_at": "2026-06-20T09:14:07+00:00",
  "data": {
    "alert_id": "019d7e3c-...",
    "incident_id": "019d7e3c-...",
    "type": "downtime",
    "severity": "critical",
    "title": "HTTP 503",
    "message": "...",
    "website": { "id": "019d7e3c-..." },
    "is_resolved": false,
    "created_at": "2026-06-20T09:14:06+00:00"
  },
  "source": "XICTRAQ"
}

# Verwandte Doku-Kapitel