Die Informationen eines Benutzerkontos ändern¶

Note

Der Body muss die Attribute id und modified enthalten, um den entsprechenden Eintrag zu identifizieren.

Note

Die ID des Eintrags im Pfad der Anfrage muss mit dem Wert des Attributs id im Body übereinstimmen.

Note

Der Body darf nur die genannten Attribute enthalten. Alle anderen möglichen Attribute des Objekts UserVO werden ignoriert.

Senden einer PUT-Anfrage an den Endpunkt /users/{id}.

Beschreibung¶

Mit der Change-User-Anfrage ändern Sie die Informationen eines Benutzerkontos der Organisation.

Voraussetzungen¶

Werte der Anfrage: User-ID {id}

Objekte: UserVO

Anfrage¶

Um die Informationen eines Benutzerkontos zu ändern, fügen Sie die User-ID {id} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Ändern der Informationen eines Benutzerkontos erforderlich sind, muss im Body das Objekt UserVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`email`	Die E-Mail-Adresse des Benutzerkontos.	`string`
`login`	Der Benutzername für die Anmeldung in der Myra App. Dieser sollte mit dem Wert für email übereinstimmen.	`string`
`id`	Die ID des Eintrags.	`integer`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`firstname`	Der Vorname des Benutzers.	`string`
`lastname`	Der Name des Benutzers.
`roles`	Ein Array mit den Berechtigungsrollen eines Benutzerkontos.	`ADMINISTRATOR` `USER`
`rootGroupRoles`	Ein Array mit Informationen zu den Gruppenberechtigungen eines Benutzerkontos.	`ADMINISTRATOR` `USER`
`isIndirectCustomer`	Zeigt an, ob es sich um ein Benutzerkonto eines Partners oder eines Direktkunden von Myra handelt.	`true` `false`

Das System gibt das Objekt UserVO mit den geänderten Informationen zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "email": "string",
  "login": "string",
  "firstname": "string",
  "lastname": "string",
  "roles": "ADMINISTRATOR",
  "rootGroupRoles": "ADMINISTRATOR",
  "isIndirectCustomer": true
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Das aktualisierte `UserVO`.
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.