/v1/decide & /v1/track

Die Feature-API besteht aus zwei Endpunkten: /v1/decide liefert die Variantenentscheidung, /v1/track meldet Conversions. Beide sind per Bearer-Token mit dem Secret-Key des Projekts authentifiziert.

/v1/decide

Du übergibst die Besucher-ID und das Experiment; die API antwortet mit der zugeteilten Variante – mit demselben Bucketing wie das Snippet.

POST /v1/decide
Authorization: Bearer <secret_key>

{ "visitor": "abc-123", "experiment": "checkout-flow" }

Antwort (vereinfacht):

{ "variation": "b", "bucketing": { "checkout-flow": "b" } }

/v1/track

Meldet eine Conversion zurück, damit sie in die Auswertung einfließt.

POST /v1/track
Authorization: Bearer <secret_key>

{ "visitor": "abc-123", "goal": "purchase", "value": 79.90 }

Konsistenz mit dem Client

Übergibst du clientseitig dieselbe Besucher-ID, stimmen Server- und Snippet-Zuteilung überein – ideal für hybride Experimente.

Rate-Limits

Die /v1/*-Endpunkte sind rate-limitiert. Plane Retries mit Backoff ein.