Quickstart

Voraussetzungen

Du benötigst ein bestehendes Projekt, dessen Slug und einen aktiven API-Token dieses Projekts. Bewahre den Token auf deinem Server als Umgebungsvariable TRACKLYTIC_API_TOKEN auf.

Event senden

Ersetze my-project durch deinen Projekt-Slug. Der Kanal deployments wird bei Bedarf angelegt.

curl -X POST 'https://api.tracklytic.de/v1/event' \
  -H "Authorization: Bearer $TRACKLYTIC_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "project": "my-project",
  "channel": "deployments",
  "event": "Deployment abgeschlossen",
  "tags": {
    "version": "2.4.0",
    "environment": "production"
  },
  "notify": false
}'

Die API antwortet mit HTTP 201 und {}. Das ist die vollständige Erstellungsantwort eines normalen Events. Öffne anschließend das Projekt und den Kanal im Dashboard.

Nutzer zuordnen

Mit userId verbindest du Events mit einem Nutzerprofil. Verwende für Identify denselben stabilen Bezeichner, beispielsweise eine interne Kunden-ID. Ein Profil ist kein Tracklytic-Login.

Weitere Felder

Der Event-Generator ergänzt Tags, Badge, Logs, Links, Buttons, Formulare und Pipeline-Steps. Die Feldreferenz beschreibt alle Event-Felder.

Fehler prüfen

Bei 400 prüfe die Feldtypen und Slugs, bei 401 den Token und bei 403 dessen Projektzuordnung. Weitere Fälle stehen unter Fehler.