API-Überblick

Die AppArch-API hat zwei Seiten: die Control Plane (Authentifizierung, Workspaces, Pakete, Projektregistrierung) und die Report API (token-geschützte Endpunkte, an die die Analyzer-Runner ihre Ergebnisse senden).

Runner-Authentifizierung

Runner weisen sich mit einem projektspezifischen Bearer-Token aus, das bei der Projektregistrierung erzeugt wird. Das Token ist auf einen einzelnen Workspace + Projekt + Modul beschränkt und kann über den Credential Manager widerrufen werden.

POST /api/v1/reports
Authorization: Bearer apparch_proj_xxxxxxxx
Content-Type: application/json

Versionierung

Die Report API ist unter /api/v1/reports versioniert. Da Runner in der Kundenumgebung nicht hot-aktualisiert werden können, wird diese Oberfläche über die Versionen hinweg stabil gehalten; Runner sind an eine Major-Version gebunden.

Systeminformationen

Sie können die Version und den Bereitstellungsmodus anonym auslesen:

GET /api/v1/system/info
→ { "version": "...", "deploymentMode": "SaaS", "serverTimeUtc": "..." }