Rest API métodos para gerenciar usuários, incluindo criação, atualização, listagem, exclusão e retorno de objetos de usuário.
A POST
para criar um novo usuário.
POST /api/v1/users/
{
"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
}
{
"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">
}
Se isAdmin
for definido como true, o usuário será criado como um administrador parceiro. Essa propriedade também permite saber se um usuário é um administrador de parceiros.
Devoluções 409 Conflict
se o nome de usuário já estiver sendo usado.
A PUT
para atualizar um usuário.
PUT /api/v1/users/
<userId>
{
"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>, ...]
}
{
"pid" : <integer>,
"userId": <integer>,
"username" : <string>,
"status" : <"ACTIVE"|"INACTIVE"|"LOCKED">
"firstName" : <string>,
"lastName" : <string>,
"email" : <string>,
"groups" : [<group_1_id>, ...]
}
Devoluções 409 Conflict
se o nome de usuário já estiver sendo usado.
A PUT
para atualizar o usuário conectado no momento.
Considerando que a maioria API Os métodos só podem ser chamados por administradores parceiros. Esse método pode ser chamado por usuários não administradores.
PUT /self/update
{
"status" : <"ACTIVE"|"INACTIVE"|"LOCKED">
"firstName" : <string>,
"lastName" : <string>,
"email" : <string>,
"title" : <string_may_be_null>,
"phoneNumber" : <string_may_be_null>
}
{
"userId": <integer>,,
"status" : <"ACTIVE"|"INACTIVE"|"LOCKED">
"firstName" : <string>,
"lastName" : <string>,
"email" : <string>
"title" : <string_may_be_null>,
"phoneNumber" : <string_may_be_null>
}
Devoluções 409 Conflict
se o nome de usuário já estiver sendo usado.
A PUT
para atualizar o usuário conectado no momento.
Considerando que a maioria API Os métodos só podem ser chamados por administradores parceiros. Esse método pode ser chamado por usuários não administradores.
POST /users/self/update-password
{ "oldPassword" : "old password", "newPassword" : "new password" }
Devoluções 200 OK
se for bem-sucedido. Devoluções 400 Bad Request
se algo estiver errado com uma senha.
A PUT
para redefinir o usuário conectado no momento. Audience Management envia ao usuário uma senha gerada pelo sistema.
Considerando que a maioria API Os métodos só podem ser chamados por administradores parceiros. Esse método pode ser chamado por usuários não administradores.
POST /self/reset-password
Devoluções 200 OK
se for bem-sucedido.
A Get
método para retornar o objeto do usuário para uma ID de usuário.
GET /api/v1/users/
<userId>
{
"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>, ...]
}
A Get
método para retornar o objeto do usuário conectado no momento.
Considerando que a maioria API Os métodos só podem ser chamados por administradores parceiros. Esse método pode ser chamado por usuários não administradores.
GET /api/v1/users/self
{
"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>, ...]
}
A GET
para listar usuários.
GET /api/v1/users/
Você pode especificar várias IDs de grupo nos parâmetros de consulta:
GET /api/v1/users/?groupId=343&groupdId=12
Esta consulta retorna uma lista de todos os usuários nos grupos especificados.
{
"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>, ...]
}
A DELETE
para excluir um usuário.
DELETE /api/v1/users/
<user_id>
Devoluções 204 No Content
se for bem-sucedido. Em caso de retornos de conflito 409 Conflict
.
A POST
para excluir vários usuários em massa.
POST /api/v1/users/bulk-delete
{[<user_id_1>, <user_id_2>, ...]}