Skip to content

Live OpenAPI-Doku ​

Die Spec wird vom Filament-Backend automatisch aus den Routen/Resources generiert (dedoc/scramble), die Doku-UI ist Redoc mit matev-Branding.

Umgebung wählen:

Spec-JSON: https://matev.ddev.site:33001/docs/api.json
Doku-UI: https://matev.ddev.site:33001/api/docs

Lokale Voraussetzung ​

DDEV muss laufen — Filament-Admin auf https://matev.ddev.site:33001:

bash
cd matev_2026/admin && ddev start

Spec direkt im Tool öffnen ​

  • Postman: Import → File → URL → https://admin.matev.eu/docs/api.json
  • Insomnia: Import → URL
  • Stoplight Studio: Datei → URL importieren
  • Bruno (CLI): bru sync /docs/api.json

Spec im Build (für Offline-Builds) ​

Wenn das VitePress-Build die Live-Doku nicht erreichen kann (z. B. CI ohne Backend-Zugriff), kann die Spec einmal manuell abgezogen werden:

bash
curl -o docs/api/openapi.yaml https://admin.matev.eu/docs/api.json

und der iframe oben durch die statische openapi.yaml ersetzt werden (via Redoc-Standalone-Bundle in einem <script>-Block).