Umgebungen

Staging

Basis-URL	https://tfs-api.karyabilisim.com
Authentifizierung	OIDC-Bearer-Token (Keycloak); Entwickler-Header nur als Fallback — siehe Authentifizierung
Daten	Ausschließlich synthetische Testdaten
Resets	Staging-Daten können mit Ankündigung periodisch zurückgesetzt werden

Staging wird aus derselben Codebasis wie die Produktion bereitgestellt; Geschäftsregeln und Fehlervertrag sind identisch.

Produktion

Die Produktions-Basis-URL ist mandantenspezifisch und wird beim Onboarding vereinbart (z. B. https://api.<ihr-unternehmen>.karyabilisim.com oder Ihre eigene Domain). Die Produktionsauthentifizierung ist OIDC; Entwickler-Header sind deaktiviert.

Request-Konventionen

• Content-Type: application/json; charset=utf-8
• Fachliche Endpunkte tragen das Präfix /api/v1/...; nicht authentifizierte Endpunkte liegen unter /api/public/....
• Schreibende Endpunkte mit Idempotenzanforderung akzeptieren einen Idempotency-Key-Header; die Wiederholung eines Schlüssels liefert das ursprüngliche Ergebnis.
• Seitenweise Listen verwenden page (0-basiert) und size (Standard 20, maximal 100).
• Jede Antwort trägt eine traceId; geben Sie sie bei Problemmeldungen an.