Infrastruktur · Die Module: was sie tun, betreiben, testen, ansteuern
API-Spine
Das maschinenlesbare Rückgrat (OpenAPI) hinter den Fassaden der Website.
Auf dieser Seite
Was es tut
Der API-Spine ist der eine typisierte Kern hinter den Fassaden: die REST-Spezifikation wird aus dem Code erzeugt, der Client wird aus der Spezifikation erzeugt, und die MCP-Werkzeugfläche bindet an dieselben Funktionen — nie eine zweite Implementierung derselben Semantik. Vierzehn Operationen, jede genau einer Zeile eines im Code stehenden Fähigkeitsregisters zugeordnet; ein Test prüft, dass Register und Spezifikation sich exakt decken, statt es zu behaupten. Datenquelle ist in dieser Phase das Register-Repository selbst, streng lesend: einen Schreibpfad gibt es im Code nicht, und /directory liefert heute null Einträge. Bei jedem Commit laufen vier Abgleiche zwischen dem, was der Code erzeugt, und dem, was eingecheckt ist — Spezifikation, erzeugter Client, RFC-9728-Metadaten und Werkzeug-Inventar; jeder Unterschied hält den Commit an. Was der Spine nicht tut: nach aussen servieren — oh-api serve bindet an 127.0.0.1, und die Website erzeugt ihre Fassaden statisch und ruft ihn nie auf; geteilt wird das Schema, nicht der Prozess.
Selbst betreiben
Sie brauchen:
- Rust (stable über rustup) und Git; alle Befehle laufen aus der Wurzel des Korpus-Checkouts.
Aus der Wurzel des Korpus-Checkouts, Zeile für Zeile:
cargo run --locked --manifest-path registry/api/spine/Cargo.toml -- serve --root . --port 8710
Danach sehen Sie:
oh-api serving on 127.0.0.1:8710
Testen
cargo test --locked --manifest-path registry/api/spine/Cargo.toml
- Läuft ohne Netz: jede Antwort kommt aus dem Repository, das Ergebnis ist bei jedem Lauf gleich.
Ansteuern
- Öffentlich: noch nicht — Kein öffentlicher Endpunkt: weder Zone noch Route noch Deployment sind aufgeschaltet.
- Lokal: http://127.0.0.1:8710
Verträge
- OpenAPI 3.0.3
registry/api/openapi.json - Erzeugter Client
registry/api/client
Das Fähigkeitsregister
curl -s http://127.0.0.1:8710/capabilities
Antwort (Auszug):
[{"id":"meta.capabilities","operation_id":"get_capabilities","method":"GET","path":"/capabilities","summary":"The machine-readable capability register with published client coverage", …}, … 14 rows]
Aufruf und Optionen
usage: oh-api emit-openapi | serve --root <dir> [--port <n>]
Mitwirken
Änderungen laufen über Merge Request und dieselben Gates wie für den Verein: Formatierung, Clippy ohne Warnungen, Tests, Siegel- und Drift-Prüfungen. Sicherheitsmeldungen vertraulich an [email protected].
Die Basis-Stufe kostet nichts; wovon der Betrieb lebt, steht unter Über uns, Finanzierung.
Steckbrief
Zustand, Belege, Download und Abhängigkeiten stehen auf der Infrastruktur-Seite: API-Spine.