API-Referenz

Basis-URL

https://api.tracklytic.de/v1

Requests und Antworten verwenden JSON. Setze für Requests mit JSON-Body Content-Type: application/json. Die Beispiele enthalten Platzhalter, keine echten Zugangsdaten.

Externe Integration

Methode	Pfad	Zweck
POST	/v1/event	Event einschließlich optionaler Pipeline erstellen.
POST	/v1/event/{eventId}/step	Pipeline-Status melden oder Folgeschritte anhängen.
POST	/v1/identify	Nutzerprofil erstellen oder aktualisieren.
POST	/v1/insight	Kennzahl oder Textwert setzen.
PATCH	/v1/insight/mutate	Numerischen Insight-Wert verändern.

Diese Endpunkte verwenden einen API-Token des zugehörigen Projekts. Die weiteren Referenzseiten kennzeichnen Lese- und Verwaltungsendpunkte mit Benutzer-Access-JWT.

Konventionen

• project und channel sind Slugs. Event-IDs kommen aus der API.
• Normale Event-Erstellung, Identify und Insight-Schreibzugriffe liefern {} bei Erfolg.
• Eine Pipeline-Erstellung liefert id, status und pipeline. Speichere die ID für Step-Updates.
• Listen liefern results, page, limit, totalPages und totalResults.
• 204 enthält keinen Antwort-Body und darf nicht als JSON geparst werden.

Authentifizierung · Fehler · Event-Generator

Feldnamen

Alle Tracklytic-Feldnamen und Query-Parameter verwenden camelCase, zum Beispiel logLevel, userId und actionId. Verwende userId sowohl für Events als auch für Identify und die zugehörigen Filter. Die früheren Namen user_id und action_id werden in Requests nicht mehr akzeptiert. Frei vergebene Schlüssel in tags, properties und details behalten deine eigene Benennung.