Explorer API Referenz

Alle serverseitigen API-Endpunkte des jinflow Explorer.

Dies sind interne Explorer-APIs, keine oeffentliche REST-API. Sie bedienen die Explorer Web-UI. Hier dokumentiert fuer Transparenz und fuer Teams, die Integrationen bauen.

---

Gesundheit & Status

GET /health

Gesundheitscheck mit DB-Konnektivitaetsstatus.

GET /api/identity

Git-Identitaet (Name/E-Mail) des aktuellen Benutzers.

GET /api/store-status

KLS-Store Download-Fortschritt. Nur im R2-Modus relevant.

GET /api/db-status/[tenant]

Leichtgewichtiger mtime/generation-Poll fuer die DbWatcher-Komponente.

---

Suche

GET /api/jumpbar

Globale Suche ueber alle Inhaltstypen. Unterstuetzt drei Modi: tenants, summary und search.

---

Inhaltsbereitstellung

GET /api/logo/[tenant]

Tenant-Logo-Bild.

GET /api/pipeline/[tenant]/[artifact_key]

Pipeline-DAG-Artefakt aus dem KLS.

GET /api/reports/[tenant]/[report_key]

PDF-Report-Blob aus der KLS report_pdfs-Tabelle.

---

Lineage & Erklaerung

GET /api/explain

Ebene 2 Lineage: Gold-Quelldatensaetze, die zu einem Finding beigetragen haben.

GET /[tenant]/api/explain/[finding_id]

Ebene 1+2 Lineage: Finding-Metadaten plus Gold-Quelldatensaetze.

POST /api/explain-narrative

Ebene 4 Lineage: KI-generierte natuerlichsprachliche Erklaerung via Claude API.

---

Drift-Erkennung

GET /api/drift

KLS Build-Commit mit GitHub Remote HEAD vergleichen.

---

KLS-Store

POST /api/refresh

Gecachte R2-Dateien invalidieren und Neudownload ausloesen.

---

Gespeicherte Views

GET /api/views

Gespeicherte Views auflisten, optional nach Entity gefiltert.

POST /api/views

Neuen gespeicherten View erstellen.

PUT /api/views

Bestehenden gespeicherten View aktualisieren.

DELETE /api/views

Gespeicherten View loeschen.

---

Signal Builder

GET /api/probe-builder/list

Alle Signal-, Perspective-, Thesis- und Verdict-Definitionen im AFS auflisten.

GET /api/probe-builder/load

YAML-Quelle fuer ein einzelnes Signal laden.

POST /api/probe-builder/save

Signal-YAML in das AFS-Signals-Verzeichnis schreiben.

POST /api/probe-builder/validate

Signal-YAML gegen Contracts validieren.

POST /api/probe-builder/compile

Signal-YAML zu SQL kompilieren.

---

Notebooks

GET /[tenant]/api/notebook

Tenant-Notebook abrufen.

POST /[tenant]/api/notebook/cells

Zelle zum Tenant-Notebook hinzufuegen.

PUT /[tenant]/api/notebook/cells/[cell_id]

Bestehende Zelle aktualisieren.

DELETE /[tenant]/api/notebook/cells/[cell_id]

Zelle loeschen.

POST /[tenant]/api/notebook/cells/[cell_id]/discussion

Antwort zu einer Diskussionszelle hinzufuegen.

GET /[tenant]/api/notes / POST / GET [note_id] / PUT / DELETE

Vollstaendige CRUD fuer Notizen. Siehe englische Referenz fuer Parameter-Details.

---

Taxonomie & Dimensionen

GET /[tenant]/taxonomies/[taxonomy_id]/members

Taxonomie-Mitglieder auflisten oder durchsuchen.

GET /[tenant]/taxonomies/cardinality/member

Cross-Taxonomy-Zuordnungen fuer ein einzelnes Mitglied.

GET /[tenant]/taxonomies/cardinality/members

Gemeinsame Mitglieder zwischen zwei Taxonomie-Knoten.

GET /[tenant]/taxonomies/cardinality/fanout

Fanout-Verteilung zwischen zwei Taxonomien.

GET /[tenant]/taxonomies/cardinality/detail

Kardinalitaetsmetriken zwischen zwei Taxonomien.

GET /[tenant]/dimensions/[entity]/export

CSV-Export einer Dimensionstabelle (bis zu 1M Zeilen).

Siehe die englische Referenz fuer vollstaendige Parameter-Dokumentation aller Endpunkte.