API-Methoden für die Benutzerverwaltung

REST API-Methoden zum Verwalten von Benutzern, einschließlich Erstellen, Aktualisieren, Auflisten, Löschen und Zurückgeben von Benutzerobjekten.

Erstellen eines Benutzers

Eine POST-Methode zum Erstellen eines neuen Benutzers.

Anfrage

POST /api/v1/users/

Beispielanfragetext

{ 
  "username" : <string>,  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email" : <string>, 
  "title" : <string_may_be_null>, 
  "phoneNumber" : <string_may_be_null>, 
  "groups" : [<group_1_id>, ...], 
  "isAdmin" : true | false 
}

Antwort

{ 
  "pid" : <integer>, 
  "userId": <integer>, 
  "username" : <string>,  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email" : <string>, 
  "title" : <string_may_be_null>, 
  "phoneNumber" : <string_may_be_null>, 
  "groups" : [<group_1_id>, ...], 
  "isAdmin" : <"true"|"false"> 
 
}

Wenn isAdmin auf "true"gesetzt ist, wird der Benutzer als Partner-Administrator erstellt. Diese Eigenschaft informiert Sie auch darüber, ob ein Benutzer Partneradministrator ist.

Gibt 409 Conflict zurück, wenn der Benutzername bereits verwendet wurde.

Aktualisieren eines Benutzers

Eine PUT-Methode zum Aktualisieren eines Benutzers.

Anfrage

PUT /api/v1/users/<userId>

Beispielanfragetext

{ 
  "username" : <string>,  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email" : <string>, 
  "title" : <string_may_be_null>, 
  "phoneNumber" : <string_may_be_null>, 
  "groups" : [<group_1_id>, ...] 
}

Antwort

{ 
  "pid" : <integer>, 
  "userId": <integer>, 
  "username" : <string>,  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email" : <string>, 
  "groups" : [<group_1_id>, ...] 
 
}

Gibt 409 Conflict zurück, wenn der Benutzername bereits verwendet wurde.

Aktualisierter angemeldeter Benutzer

Eine PUT -Methode zum Aktualisieren des aktuell angemeldeten Benutzers.

HINWEIS

Während die meisten API-Methoden nur von Partneradministratoren aufgerufen werden können, ist diese Methode von Benutzern ohne Administratorrechte abrufbar.

Anfrage

PUT /self/update

Beispielanfragetext

{  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email" : <string>, 
  "title" : <string_may_be_null>, 
  "phoneNumber" : <string_may_be_null> 
}

Antwort

{ 
  "userId": <integer>,,  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email" : <string> 
  "title" : <string_may_be_null>, 
  "phoneNumber" : <string_may_be_null> 
}

Gibt 409 Conflict zurück, wenn der Benutzername bereits verwendet wurde.

Aktualisieren des angemeldeten Benutzerkennworts

Eine PUT -Methode zum Aktualisieren des aktuell angemeldeten Benutzers.

HINWEIS

Während die meisten API-Methoden nur von Partneradministratoren aufgerufen werden können, ist diese Methode von Benutzern ohne Administratorrechte abrufbar.

Anfrage

POST /users/self/update-password

Beispielanfragetext

{ "oldPassword" : "old password", "newPassword" : "new password" }

Gibt 200 OK zurück, falls erfolgreich. Gibt 400 Bad Request zurück, wenn bei beiden Passwörtern etwas nicht stimmt.

Zurücksetzen des angemeldeten Benutzerkennworts

Eine PUT -Methode zum Zurücksetzen des derzeit angemeldeten Benutzers. Audience Management sendet dem Benutzer ein systemgeneriertes Kennwort.

HINWEIS

Während die meisten API-Methoden nur von Partneradministratoren aufgerufen werden können, ist diese Methode von Benutzern ohne Administratorrechte abrufbar.

Anfrage

POST /self/reset-password

Gibt 200 OK zurück, falls erfolgreich.

Zurückgeben eines Benutzerobjekts für eine Benutzer-ID

Eine Get -Methode, mit der das Benutzerobjekt für eine Benutzer-ID zurückgegeben wird.

Anfrage

GET /api/v1/users/<userId>

Antwort

{ 
  "pid" : <integer>, 
  "userId": <integer>, 
  "username" : <string>,  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email" : <string>, 
  "title" : <string_may_be_null>, 
  "phoneNumber" : <string_may_be_null>, 
  "groups" : [<groupd_id_1>, ...] 
 
}

Zurückgeben des Benutzerobjekts für angemeldeten Benutzer

Eine Get -Methode, um das Benutzerobjekt für den derzeit angemeldeten Benutzer zurückzugeben.

HINWEIS

Während die meisten API-Methoden nur von Partneradministratoren aufgerufen werden können, ist diese Methode von Benutzern ohne Administratorrechte abrufbar.

Anfrage

GET /api/v1/users/self

Antwort

{ 
  "pid" : <integer>, 
  "userId": <integer>, 
  "username" : <string>,  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email" : <string>, 
  "title" : <string_may_be_null>, 
  "phoneNumber" : <string_may_be_null>, 
  "groups" : [<groupd_id_1>, ...] 
 
}

Benutzer auflisten

Eine GET-Methode zur Auflistung von Benutzern.

Anfrage

GET /api/v1/users/

Sie können mehrere Gruppen-IDs in den Abfrageparametern angeben:

GET /api/v1/users/?groupId=343&groupdId=12

Diese Abfrage gibt eine Liste aller Benutzer in den angegebenen Gruppen zurück.

Antwort

{ 
  "pid" : <integer>, 
  "userId": <integer>, 
  "username" : <string>,  
  "status" : <"ACTIVE"|"INACTIVE"|"LOCKED"> 
  "firstName" : <string>, 
  "lastName" : <string>, 
  "email : <string>, 
  "title" : <string_may_be_null>, 
  "phoneNumber" : <string_may_be_null>, 
  "groups" : [<group_1_id>, ...] 
 
}

Löschen eines Benutzers

Eine DELETE-Methode zum Löschen eines Benutzers.

Anfrage

DELETE /api/v1/users/<user_id>

Gibt 204 No Content zurück, falls erfolgreich. Im Falle eines Konflikts wird 409 Conflict zurückgegeben.

Benutzer stapelweise löschen

Eine POST-Methode zum Löschen mehrerer Benutzer in großen Mengen.

Anfrage

POST /api/v1/users/bulk-delete

Beispielanfragetext

{[<user_id_1>, <user_id_2>, ...]}

Auf dieser Seite