Der Heimdall API Explorer ist eine eigenständige, interaktive Entwickler-Konsole zur Demonstration, Verifizierung und Analyse des Svalinn Security Gateways.

Mit dieser Sandbox können Entwickler und Sicherheits-Auditoren die Funktionsweise der API-Endpunkte und den Datenfluss live nachvollziehen.

• Interaktiver Request Composer: Wähle einen Svalinn-Endpunkt aus und editiere direkt den JSON-Request-Body.
• Formatierter Response Viewer: Anzeige des HTTP-Statuscodes und automatisches Syntax-Highlighting für API-Antworten.
• Live-Datenfluss-Visualizer (Flow Engine): Animierte Pfade leuchten auf, um zu zeigen, welche Komponenten (PII Shield, SQLite-Mappings, Gemini API) bei jedem API-Aufruf aktiv sind.
• CORS-kompatibel: Kommuniziert direkt mit dem laufenden Svalinn-Gateway unter http://localhost:5001.

Stelle sicher, dass der Svalinn-Server läuft und CORS aktiv ist:

cd svalinn
.venv/bin/python main.py

(Svalinn läuft standardmäßig auf Port 5001).

1. Abhängigkeiten installieren: Erstelle eine virtuelle Umgebung im Explorer-Verzeichnis und installiere die minimalen Anforderungen:

   cd heimdall_api_explorer
   python3 -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

2. Webserver starten: Starte den eigenständigen Webserver für den Explorer:

   python app.py

   (Der Explorer startet standardmäßig auf Port 5002).

3. Im Browser öffnen: Rufe folgende Adresse auf: 👉 http://localhost:5002

4. API-Schlüssel eingeben: Beim ersten Laden wirst du nach deinem Svalinn-API-Key gefragt (dieser wird lokal im Browser-LocalStorage gespeichert und für die X-API-Key-Header verwendet).

• app.py: Der eigenständige FastAPI-Server, der die Konsole bereitstellt.
• index.html: Das HTML5-Aero-Layout der Konsole.
• explorer.js: Die Javascript-Steuerung für Request-Ausführung und Flussdiagramm-Animationen.
• explorer.css: Das Stylesheet im dunklen Aero-Glassmorphismus-Design.