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 und eigene Integrationen, also alles, was das Snippet unter der Haube sendet. |
| JavaScript-API | Die globale visz(...)-Command-Queue, die das Tracking-Snippet bereitstellt. | Eigene Ereignisse, Identify und Consent-Steuerung aus deinem eigenen Seiten-Code. Für die meisten Integrationen ist das die richtige Wahl. |
| Webhooks | Signierte, ausgehende HTTP-Aufrufe, die dein Arbeitsbereich abonnieren kann. | Auf Meldungen wie eine Häufung frustrierter Sitzungen, einen Fehler während eines Kaufvorgangs oder eine Erwähnung 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. Ohne Code geht es auch: siehe Custom Events & Tags. - „Ich sende Daten aus meinem Backend oder einem Nicht-Browser-Client.“ Nimm die REST-API direkt mit deinem Tracking-Key.
- „Ich will benachrichtigt werden, wenn in visz.ai etwas passiert.“ Richte einen Webhook ein.
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 denX-Tracking-Key-Header authentifiziert. Er ist bewusst öffentlich; er steckt in deinem Tracking-Snippet. /v1/healthund/v1/share/{token}brauchen keine Authentifizierung.- Webhooks werden andersherum authentifiziert: Du prüfst über den
X-Visz-Signature-HMAC mit deinem eigenen Signatur-Secret, dass ein Request wirklich von visz.ai kommt.
Zuletzt aktualisiert: