API-Referenz Verfügbar (v1)

Visz.ai bietet drei öffentliche Schnittstellen. Wähl die, die zu deiner Aufgabe passt — sie decken unterschiedliche Ebenen ab, und du brauchst selten mehr als eine.

Schnittstelle	Was sie ist	Wofür du sie nutzt
REST-API (`/v1`)	Die HTTP-Ingest-Oberfläche unter `https://ingest.visz.ai`. Authentifiziert mit deinem öffentlichen Tracking-Key (`X-Tracking-Key`).	Server-seitige Ingestion, eigene Integrationen — alles, was das Snippet unter der Haube sendet.
JavaScript-API	Die globale `visz(...)`-Command-Queue, die das Tracking-Snippet bereitstellt.	Custom Events, Tags, Identify und Consent-Steuerung aus deinem eigenen Seiten-Code. Das ist, was 95 % der Nutzer brauchen.
Webhooks	Signierte, ausgehende HTTP-Callbacks, die dein Workspace abonnieren kann.	Auf Alerts (Frustrations-Spikes, Error-Spikes, Conversion-Drops) in deinen eigenen Systemen reagieren.

Welche will ich?

„Ich will nur einen Button-Klick oder einen Kauf tracken.“ → Nimm die JavaScript-API. Du rufst visz('event', ...) aus deiner Seite auf — das Snippet übernimmt Batching, Consent und PII-Maskierung für dich.
„Ich sende Daten aus meinem Backend / einem Nicht-Browser-Client.“ → Nimm die REST-API direkt mit deinem Tracking-Key.
„Ich will benachrichtigt werden, wenn in Visz etwas passiert.“ → Abonniere einen Webhook.

Anmerkung zu tRPC

Das Dashboard von Visz.ai spricht mit seinem Backend über eine interne tRPC-API. Diese API ist kein öffentlicher Vertrag: Sie ist undokumentiert, unversioniert und kann sich jederzeit ändern. Die einzigen öffentlichen, stabilen Schnittstellen sind die drei oben — REST /v1, die JavaScript-Snippet-API und Webhooks.

Authentifizierung im Überblick

REST-/v1-Ingest-Routen werden mit deinem öffentlichen Tracking-Key (vz_…) über den X-Tracking-Key-Header authentifiziert. Er ist bewusst öffentlich — er steckt in deinem Tracking-Snippet.
/v1/health und /v1/share/{token} brauchen keine Authentifizierung.
Webhooks werden andersherum authentifiziert: Du prüfst über den X-Visz-Signature-HMAC, dass ein Request wirklich von Visz kommt.

Zuletzt aktualisiert: 5. Juni 2026