Handbuch · 9
Auth- & Benutzer-Endpunkte
| Methode | Pfad | Beschreibung |
|---|---|---|
| POST | /auth/login |
Anmelden (siehe Authentifizierung) |
| POST | /auth/logout |
Abmelden |
| GET | /auth/me |
Eigenen Benutzer abrufen |
| GET | /auth/setup-status |
Prüft, ob die Erst-Einrichtung noch aussteht (öffentlich). Antwort { "needs_setup", "manual_available", "demo_available" } – die beiden letzten sagen, ob Handbuch und Demo-Daten installiert werden können (nur solange needs_setup gilt) |
| POST | /auth/setup |
Ersten Admin-Account anlegen (nur wenn noch kein Benutzer existiert, öffentlich). Body { "username", "password", "manual": true, "demo": false } – manual (fehlt = true) installiert das Handbuch, demo die Demo-Daten, siehe Einrichtung. Antwort 201 mit dem Benutzer plus manual_installed/demo_installed. Nicht verfügbare Option: 400 manual_unavailable/demo_unavailable (es wird nichts angelegt). Fehler beim Installieren: 500 manual_install_failed/demo_install_failed – der Account und die Sitzung bleiben bestehen |
| GET | /auth/tokens |
Eigene API-Tokens auflisten |
| POST | /auth/tokens |
Neues API-Token anlegen (Wert nur einmal sichtbar) |
| DELETE | /auth/tokens/{id} |
API-Token widerrufen |
| POST | /auth/users/{id}/password |
Eigenes Passwort ändern |
| GET | /auth/users |
Alle Benutzer auflisten (Admin) |
| POST | /auth/users |
Benutzer anlegen (Admin) |
| PATCH | /auth/users/{id} |
Benutzer bearbeiten (Admin) |
| DELETE | /auth/users/{id} |
Benutzer löschen (Admin) |
| GET | /auth/users/{id}/groups |
Gruppen eines Benutzers |
| GET | /auth/users/{id}/table-permissions |
Tabellen-Berechtigungen eines Benutzers (Admin) |
| PUT | /auth/users/{id}/table-permissions |
Tabellen-Berechtigungen setzen (Admin) |