ERP Holzbau · API-Wiki · Anmeldung und Sitzung
Anmeldung und Sitzung
Jeder Aufruf läuft im Namen eines Benutzers Ihres Betriebs. Sie melden sich mit Mandant, Benutzername und Passwort an und erhalten ein Sitzungs-Token, das Sie bei allen weiteren Aufrufen im Kopf „Authorization“ mitsenden.
Anmelden
Die Antwort enthält das Token, den Ablaufzeitpunkt und das Benutzerobjekt mit Rollen und Rechten. Nach fünf Fehlversuchen wird das Konto vorübergehend gesperrt. Die Sitzungsdauer legt die Administration Ihres Betriebs fest (Vorgabe: 12 Stunden).
| Methode | Pfad | Recht | Zweck |
|---|---|---|---|
| POST | /auth/login | öffentlich | Anmelden mit tenant, username, password; liefert token, expiresAt, user |
| GET | /auth/invitation/:token | öffentlich | Einladung anzeigen |
| POST | /auth/invitation/accept | öffentlich | Einladung annehmen, Passwort setzen und anmelden |
Sitzung
| Methode | Pfad | Recht | Zweck |
|---|---|---|---|
| GET | /auth/me | angemeldet | Eigener Benutzer mit Mandant, Rollen und Rechten |
| POST | /auth/logout | angemeldet | Diese Sitzung beenden |
| POST | /auth/logout-all | angemeldet | Alle eigenen Sitzungen beenden |
| POST | /auth/logout-others | angemeldet | Alle anderen eigenen Sitzungen beenden |
| POST | /auth/password | angemeldet | Eigenes Passwort ändern |
| POST | /auth/jwt | angemeldet | Kurzlebiges JWT für API-Clients ausstellen (an die Sitzung gebunden; nur wenn für die Plattform aktiviert) |
Stand 04.10.2026 · Fehlt etwas oder stimmt etwas nicht? Schreiben Sie uns.