This is a translation of the original English documentation page. Help us make it better.

user.update

Beschrijving

object user.update(object/array users)

Deze methode maakt het mogelijk om bestaande gebruikers bij te werken.

Deze methode is beschikbaar voor gebruikers van elk type. Permissies om de methode te gebruiken kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruikersrollen voor meer informatie.

De sterkte van het wachtwoord van de gebruiker wordt gevalideerd volgens de regels van het wachtwoordbeleid dat is gedefinieerd door de Authenticatie API. Zie Authenticatie API voor meer informatie.

Parameters

(object/array) Gebruikerseigenschappen die moeten worden bijgewerkt.

De eigenschap userid moet worden gedefinieerd voor elke gebruiker, alle andere eigenschappen zijn optioneel. Alleen de meegegeven eigenschappen worden bijgewerkt, alle andere blijven ongewijzigd.

Naast de standaard gebruikerseigenschappen accepteert de methode de volgende parameters.

Parameter Type Beschrijving
current_passwd string Het huidige wachtwoord van de gebruiker.

De waarde van deze parameter kan een lege tekenreeks zijn als de gebruiker is gekoppeld aan een gebruikersmap.

Gedrag van de parameter:
- alleen schrijven
- verplicht als passwd van gebruikersobject is ingesteld en de gebruiker zijn eigen wachtwoord wijzigt
usrgrps array Gebruikers groepen om bestaande gebruikersgroepen te vervangen.

De gebruikersgroepen moeten de eigenschap usrgrpid gedefinieerd hebben.
medias array Gebruikersmedia om bestaande media te vervangen.

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte gebruikers bevat onder de eigenschap userids.

Voorbeelden

Een gebruiker hernoemen

Hernoem een gebruiker naar John Doe.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "user.update",
           "params": {
               "userid": "1",
               "name": "John",
               "surname": "Doe"
           },
           "id": 1
       }
Copy
✔ Copied

Reactie:

{
           "jsonrpc": "2.0",
           "result": {
               "userids": [
                   "1"
               ]
           },
           "id": 1
       }
Copy
✔ Copied

Gebruikersrol wijzigen

Wijzig de rol van een gebruiker.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "user.update",
           "params": {
               "userid": "12",
               "roleid": "6"
           },
           "id": 1
       }
Copy
✔ Copied

Reactie:

{
           "jsonrpc": "2.0",
           "result": {
               "userids": [
                   "12"
               ]
           },
           "id": 1
       }
Copy
✔ Copied

Zie ook

Bron

CUser::update() in ui/include/classes/api/services/CUser.php.

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.