DocumentaçãoAudience ManagerGuia do usuário do Audience Manager

Métodos da API de gerenciamento de usuários user-management-api-methods

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Restaure API métodos para gerenciar usuários, incluindo criação, atualização, listagem, exclusão e retorno de objetos de usuário.

Criar um usuário create-user

Um método POST para criar um novo usuário.

Solicitação

POST /api/v1/users/

Exemplo de corpo da solicitação

{
  "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
}

Resposta

{
  "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 estiver definido como verdadeiro, o usuário será criado como administrador parceiro. Essa propriedade também permite saber se um usuário é um administrador de parceiros.

Retorna 409 Conflict se o nome de usuário já estiver em uso.

Atualizar um usuário update-user

Um método PUT para atualizar um usuário.

Solicitação

PUT /api/v1/users/<userId>

Exemplo de corpo da solicitação

{
  "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>, ...]
}

Resposta

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

}

Retorna 409 Conflict se o nome de usuário já estiver em uso.

Atualizar Usuário Conectado update-logged-in-user

Um método PUT para atualizar o usuário conectado no momento.

NOTE
Embora a maioria dos métodos API possa ser chamada apenas por administradores parceiros, esse método pode ser chamado por usuários não administradores.

Solicitação

PUT /self/update

Exemplo de corpo da solicitação

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

Resposta

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

Retorna 409 Conflict se o nome de usuário já estiver em uso.

Atualizar Senha do Usuário Conectado update-logged-in-user-pw

Um método PUT para atualizar o usuário conectado no momento.

NOTE
Embora a maioria dos métodos API possa ser chamada apenas por administradores parceiros, esse método pode ser chamado por usuários não administradores.

Solicitação

POST /users/self/update-password

Exemplo de corpo da solicitação

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

Retorna 200 OK em caso de sucesso. Retorna 400 Bad Request se algo estiver errado com uma das senhas.

Redefinir Senha do Usuário Conectado reset-logged-in-user-pw

Um método PUT para redefinir o usuário conectado no momento. Audience Management envia ao usuário uma senha gerada pelo sistema.

NOTE
Embora a maioria dos métodos API possa ser chamada apenas por administradores parceiros, esse método pode ser chamado por usuários não administradores.

Solicitação

POST /self/reset-password

Retorna 200 OK em caso de sucesso.

Retornar objeto de usuário para uma ID de usuário return-user-object-for-id

Um método Get para retornar o objeto de usuário para uma ID de Usuário.

Solicitação

GET /api/v1/users/<userId>

Resposta

{
  "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>, ...]

}

Retornar objeto de usuário para usuário conectado return-user-object-for-logged-in-user

Um método Get para retornar o objeto do usuário conectado no momento.

NOTE
Embora a maioria dos métodos API possa ser chamada apenas por administradores parceiros, esse método pode ser chamado por usuários não administradores.

Solicitação

GET /api/v1/users/self

Resposta

{
  "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>, ...]

}

Listar Usuários list-users

Um método GET para listar usuários.

Solicitação

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.

Resposta

{
  "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>, ...]

}

Excluir um usuário delete-users

Método DELETE para excluir usuário.

Solicitação

DELETE /api/v1/users/<user_id>

Retorna 204 No Content em caso de sucesso. Em caso de conflito retorna 409 Conflict.

Excluir usuários em massa delete-users-bulk

Um método POST para excluir vários usuários em massa.

Solicitação

POST /api/v1/users/bulk-delete

Exemplo de corpo da solicitação

{[<user_id_1>, <user_id_2>, ...]}
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695