Verwaltung
Einstellungen, Benutzer, Watcher, Audit-Logs — die APIs für den Betrieb. Die meisten erfordern Administratorrechte.
Einstellungen
| Methode | Pfad | Funktion |
|---|---|---|
GET | /api/settings | Alle Einstellungen |
PUT | /api/settings | Einstellungen speichern (nur geänderte Einträge) |
POST | /api/settings/test-platform | Platform-Integrationsschlüssel tatsächlich testen |
POST | /api/settings/mcp/refresh | MCP-Serverliste aktualisieren (serverId im Body, ohne Angabe alle) |
Die Einstellungen der AI-Anbieter befinden sich unter ai.
{
"ai": { "provider": "anthropic", "model": "...", "baseUrl": "..." }
}
Der Schlüsselwert selbst ist nicht in der Antwort enthalten. Er wird gespeichert, kann aber nicht erneut gelesen werden.
Branding
| Methode | Pfad | Funktion |
|---|---|---|
PUT | /api/settings | Markenname ({ "brandName": "..." }) |
POST | /api/settings/branding-logo | Logo hochladen (mime, dataBase64) |
DELETE | /api/settings/branding-logo | Logo entfernen |
Benutzer
| Methode | Pfad | Funktion |
|---|---|---|
GET | /api/users | Benutzerliste |
GET | /api/users/directory | Kurzliste zur Auswahl von Freigabezielen |
POST | /api/users | Benutzer anlegen (userId, password, name, role) |
PUT | /api/users/{id} | Name/Rolle ändern |
POST | /api/users/{id}/password | Passwort zurücksetzen |
DELETE | /api/users/{id} | Löschen |
POST | /api/users/{id}/avatar | Profilbild (mime, dataBase64) |
GET | /api/avatar/{loginId} | Profilbild abrufen |
{id} wird URL-codiert.
Watcher
Ein Watcher ist eine Überwachungsregel, die in einem festgelegten Intervall läuft und meldet, sobald eine Bedingung zutrifft.
| Methode | Pfad | Funktion |
|---|---|---|
GET | /api/watchers | Liste |
POST | /api/watchers/draft | Watcher-Entwurf aus natürlichsprachlicher Beschreibung erzeugen (text im Body) |
POST | /api/watchers | Anlegen (name, instruction, intervalMinutes) |
PATCH | /api/watchers/{id} | Ändern |
DELETE | /api/watchers/{id} | Löschen |
POST | /api/watchers/{id}/run | Sofort ausführen, ohne auf das Intervall zu warten |
Die Entwurfs-API existiert, weil eine Formulierung wie „Melde mir, wenn die Verdichter-Austrittstemperatur in Linie 3 über 90 °C steigt" schneller geht, als die Bedingung von Hand zu schreiben.
Benachrichtigungen
| Methode | Pfad | Funktion |
|---|---|---|
GET | /api/notifications?limit={n}&offset={n}&q={검색어} | Benachrichtigungsliste |
GET | /api/notifications/unread | Ungelesene |
POST | /api/notifications/seen | Alle als gelesen markieren |
GET | /api/notifications/stream | Neue Benachrichtigungen per Streaming empfangen |
Audit und Nutzung
| Methode | Pfad | Funktion |
|---|---|---|
GET | /api/audit?offset={n}&limit={n}&q={검색어} | Audit-Log (standardmäßig 50 Einträge) |
GET | /api/usage?days={n} | Nutzung (standardmäßig 30 Tage) |
GET | /api/stats/overview?days={n} | Statistikübersicht |
GET | /api/activity | Letzte Aktivitäten |
Templates und Galerie
| Methode | Pfad | Funktion |
|---|---|---|
GET | /api/templates | Template-Liste |
DELETE | /api/templates/{key} | Template löschen |
GET | /api/gallery/{id}/doc | Beschreibungsdokument eines Galerie-Eintrags |
Onboarding
GET /api/onboarding
Liefert den Anleitungsstatus, der Benutzern beim ersten Zugriff angezeigt wird.