Feature Flags

Die Feature Flags API ermöglicht die dynamische Steuerung von Features zur Laufzeit.

Endpunkte

Methode	Endpunkt	Beschreibung
`GET`	`/api/v1/feature-flags`	Alle Flags auflisten
`POST`	`/api/v1/feature-flags`	Neues Flag erstellen
`GET`	`/api/v1/feature-flags/{id}`	Einzelnes Flag abrufen
`PUT`	`/api/v1/feature-flags/{id}`	Flag aktualisieren
`DELETE`	`/api/v1/feature-flags/{id}`	Flag löschen
`POST`	`/api/v1/feature-flags/evaluate`	Flags evaluieren

Das FeatureFlag-Objekt

{
  "id": "flag_abc123",
  "key": "new_editor",
  "name": "Neuer Editor",
  "description": "Aktiviert den neuen WYSIWYG-Editor",
  "enabled": true,
  "type": "boolean",
  "defaultValue": false,
  "rules": [
    {
      "type": "percentage",
      "value": 50,
      "description": "50% der Benutzer"
    }
  ],
  "createdAt": "2026-01-10T08:00:00Z",
  "updatedAt": "2026-01-22T12:00:00Z"
}

Flags evaluieren

POST /api/v1/feature-flags/evaluate

{
  "flags": ["new_editor", "ai_features", "dark_mode"],
  "context": {
    "userId": "user_abc123",
    "organizationId": "org_xyz789",
    "plan": "professional"
  }
}

Response

{
  "success": true,
  "data": {
    "new_editor": true,
    "ai_features": true,
    "dark_mode": false
  }
}

Flag-Typen

Typ	Wert-Beispiel	Beschreibung
`boolean`	`true/false`	Einfaches An/Aus
`string`	`"variant-a"`	Textwert (A/B-Tests)
`number`	`100`	Numerischer Wert
`json`	`{...}`	Komplexe Konfiguration

Fehler

Code	Beschreibung
`400`	Ungültige Flag-Konfiguration
`401`	Nicht authentifiziert
`404`	Flag nicht gefunden