Docs / Referenz / Reference / API-Referenz
API-Referenz — LLMinONE Docs
Wofür diese Referenz ist
LLMinONE spricht eine schlanke JSON-API. Alles, was die Web-App tut — bauen, ändern, speichern, teilen, Analytics — läuft über die folgenden Endpunkte. Rufe sie immer mit abschließendem Schrägstrich auf (/api/chat/), sonst leitet der Server um und verliert bei POST den Body.
Authentifizierung
Zwei Wege: ein Bearer-Token aus Login oder Registrierung (Authorization: Bearer <token>) für Mitglieder, oder eine Geräte-ID (deviceId im Body) für anonyme Besucher. Anonyme Besucher haben ein Tageslimit an Builds; Mitglieder nutzen die volle Engine ohne dieses Limit. Admin-Endpunkte verlangen zusätzlich die Admin-Rolle.
Kernendpunkte
| Methode & Pfad | Zweck | Wichtigste Felder |
|---|---|---|
POST /api/chat/ | App bauen, ändern oder chatten | messages[], lang, style, refine, projectId, fileId, saveFile, deviceId |
POST /api/projects/ | Projekte lesen und schreiben (Aktionen: create, get, save, list, chat, publish, unpublish) | action, projectId, deviceId |
GET /api/pulse/ | Live-Kennzahlen der Plattform | Antwort: buildsToday, liveNow, engine; mit Admin-Token zusätzlich errRollup und earlyWarning |
GET /api/config/ | Verfügbare Modelle, Personas und Funktionsschalter | Antwort: connected, providers[], personas[], settings |
POST /api/auth/ | Registrieren, E-Mail-Code prüfen, Login, Logout | action, email, password, code |
POST /api/track/ | Seitenaufruf oder Ereignis zählen (Analytics) | page |
GET /api/share/ · /s/<token> | Veröffentlichte App ansehen | token |
/api/appstore/ · /api/appdata/ | App-Store-Einträge und App-Daten (Zeilen/Bytes je nach Kontingent) | action, appId, rows |
Admin-Endpunkte
Das Admin-Panel und das In-App-Dashboard nutzen POST /api/admin/ mit einer action: get (Einstellungen), set (Regler speichern), analytics/insights (Traffic, Länder, Browser, Top-Prompts), system (Nutzer, Projekte, Vault, Cache, Router-Gesundheit, Fehlerbudget pro Route), calls (API-Aufrufe und Kosten), auditReport sowie exportCsv. Zusätzlich liefert GET /admin/errrollup.php das Fehlerbudget als JSON — nur mit gültiger Admin-Session.
Antwortformate
Erfolg liefert {"ok":true, ...}. Fehler kommen als {"error":{"code":"...","message":"..."}} mit passendem HTTP-Status: 400 für ungültige Anfragen, 401/403 für fehlende Rechte, 429, wenn das Tageslimit erreicht ist, 502, wenn das Modell nicht antwortet. Beim Bauen streamt der Server Fortschritt als Server-Sent-Events (Phasen send, reason, write, save), danach folgt das fertige Artefakt.
Grenzen und Verhalten
Anonyme Besucher erhalten pro Tag ein begrenztes Build-Kontingent; Änderungen an bestehenden Apps sind für Mitglieder freigeschaltet. Ein laufender Build darf nicht durch einen Reload abgebrochen werden — der Server arbeitet weiter und legt das Ergebnis im Projekt ab. Wiederholte identische Wünsche kommen aus dem Cache und kosten keine Tokens.