사용자 개체 만들기, 업데이트, 목록 지정, 삭제 및 반환 등 나머지 API 메서드를 사용하여 사용자를 관리합니다.
새 사용자를 만드는 POST
메서드입니다.
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">
}
isAdmin
이 true로 설정되면 사용자가 파트너 관리자로 생성됩니다. 또한 이 속성을 사용하면 사용자가 파트너 관리자인지 여부를 알 수 있습니다.
사용자 이름이 이미 사용되면 409 Conflict
을 반환합니다.
사용자를 업데이트하는 PUT
메서드입니다.
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>, ...]
}
사용자 이름이 이미 사용되면 409 Conflict
을 반환합니다.
현재 로그인한 사용자를 업데이트하는 PUT
메서드입니다.
대부분의 API 메서드는 파트너 관리자만 호출할 수 있지만, 관리자가 아닌 사용자는 이 메서드를 호출할 수 있습니다.
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>
}
사용자 이름이 이미 사용되면 409 Conflict
을 반환합니다.
현재 로그인한 사용자를 업데이트하는 PUT
메서드입니다.
대부분의 API 메서드는 파트너 관리자만 호출할 수 있지만, 관리자가 아닌 사용자는 이 메서드를 호출할 수 있습니다.
POST /users/self/update-password
{ "oldPassword" : "old password", "newPassword" : "new password" }
성공하면 200 OK
을 반환합니다. 두 암호 중 하나에 잘못된 경우 400 Bad Request
을 반환합니다.
현재 로그인한 사용자를 재설정하는 PUT
메서드입니다. Audience Management 시스템에서 생성한 암호를 사용자에게 보냅니다.
대부분의 API 메서드는 파트너 관리자만 호출할 수 있지만, 관리자가 아닌 사용자는 이 메서드를 호출할 수 있습니다.
POST /self/reset-password
성공하면 200 OK
을 반환합니다.
사용자 ID에 대한 사용자 개체를 반환하는 Get
메서드입니다.
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>, ...]
}
현재 로그인한 사용자에 대한 사용자 개체를 반환하는 Get
메서드입니다.
대부분의 API 메서드는 파트너 관리자만 호출할 수 있지만, 관리자가 아닌 사용자는 이 메서드를 호출할 수 있습니다.
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>, ...]
}
사용자를 나열하는 GET
메서드입니다.
GET /api/v1/users/
쿼리 매개 변수에서 여러 그룹 ID를 지정할 수 있습니다.
GET /api/v1/users/?groupId=343&groupdId=12
이 쿼리는 지정된 그룹의 모든 사용자 목록을 반환합니다.
{
"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>, ...]
}
사용자를 삭제하는 DELETE
메서드입니다.
DELETE /api/v1/users/
<user_id>
성공하면 204 No Content
을 반환합니다. 충돌의 경우 409 Conflict
을 반환합니다.
여러 사용자를 일괄 삭제하는 POST
메서드입니다.
POST /api/v1/users/bulk-delete
{[<user_id_1>, <user_id_2>, ...]}