Den eigenen Benutzer erneut authentifizieren¶
Note
Zur Bestätigung des Wechsels muss dieselbe Sitzung verwendet werden, indem /user/me aufgerufen wird.
Senden einer POST-Anfrage an den Endpunkt /user/reauthenticate.
Beschreibung¶
Mit der Re-authenticate-User-Anfrage authentifizieren Sie Ihr Benutzerkonto der Organisation erneut.
Voraussetzungen¶
Werte der Anfrage: keine
Objekte: ReauthenticationVO
Anfrage¶
Um Ihr eigenes Benutzerkonto erneut zu authentifizieren, müssen dem Pfad der Anfrage keine weiteren Informationen hinzugefügt werden.
Für eine detaillierte Spezifikation, welche Informationen zur erneuten Authentifizierung Ihres Benutzerkontos erforderlich sind, muss im Body das Objekt ReauthenticationVO mit den folgenden Attributen definiert werden:
| Attribut | Beschreibung | Werte |
|---|---|---|
credentials |
Passwort für Ihr Benutzerkonto. | string |
Bei einer erfolgreichen Anfrage gibt das System ausschließlich den HTTP-Code 200 zurück.
Beispiel¶
Beispiel-Request-Body:
Antworten¶
Die folgenden Antworten sind möglich:
| STATUSCODE | BESCHREIBUNG |
|---|---|
| 201 | Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt. |
| 400 | Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen. |
| 401 | Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war. |
| 403 | Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen. |