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).

MethodePfadRechtZweck
POST/auth/loginöffentlichAnmelden mit tenant, username, password; liefert token, expiresAt, user
GET/auth/invitation/:tokenöffentlichEinladung anzeigen
POST/auth/invitation/acceptöffentlichEinladung annehmen, Passwort setzen und anmelden

Sitzung

MethodePfadRechtZweck
GET/auth/meangemeldetEigener Benutzer mit Mandant, Rollen und Rechten
POST/auth/logoutangemeldetDiese Sitzung beenden
POST/auth/logout-allangemeldetAlle eigenen Sitzungen beenden
POST/auth/logout-othersangemeldetAlle anderen eigenen Sitzungen beenden
POST/auth/passwordangemeldetEigenes Passwort ändern
POST/auth/jwtangemeldetKurzlebiges 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.