So funktioniert es
Sende deine Flowg8-E-Mail und dein Passwort vertraulich über HTTPS. AWS-Konto, Client-ID, Client-Secret, API-Key und vorherige Browser-Anmeldung sind nicht erforderlich. Dies ist die Flowg8-JSON-Anmeldung, kein OAuth-Passwort-Grant. Passwörter und zurückgegebene Tokens gehören weder in KI-Anfragen noch in Logs oder Quellcode.
Bei status=authenticated verwendest du accessToken als FLOWG8_ACCESS_TOKEN im Authorization: Bearer-Header. expiresAt und expiresIn beschreiben seine Gültigkeit. Bewahre refreshToken für die Erneuerung im Backend auf. Tokens gewähren nur die jeweiligen Organisationsrechte des angemeldeten Nutzers. Ermittle die Organisation mit POST /v1/workspace {} und sende ihre ID in X-Organization-Id. Nur Live-Administratoren dürfen Nutzer einschließlich Admins einladen.
Ein temporäres Passwort oder MFA liefert status=challenge_required mit challenge und kurzlebigem undurchsichtigem challengeToken. Schließe POST /v1/auth/challenge ab, bevor du einen Access-Token erhältst. Ungültige Zugangsdaten liefern 401, notwendige E-Mail-Bestätigung/Passwort-Wiederherstellung 409, Anfragelimits 429. Pro Instanz gelten 20 Token-/Challenge-Anfragen pro IP und Minute. Wiederhole Anmeldungen nicht in einer engen Schleife.
Workspace-Zugriff erfordert einen eingerichteten Authenticator. Richte ihn zuerst im Browser unter /security ein. Jeder API-Aufruf prüft den Token online und aktualisiert Gruppenrechte. Abmelden widerruft alle laufenden Cognito-Sitzungen. Die API-Anmeldung kann eine MFA-Challenge liefern.
Request-Body
grantTypestringerforderlichpasswordemailstringerforderlichemail · max length 254passwordstringerforderlichmin length 1 · max length 256Grundlagen des Aufrufs
- Authorization
- Nicht erforderlich
- X-Organization-Id
- Nicht erforderlich