# 사용자 정보 관리
## 사용자 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UserListRequest":{"type":"object","description":"사용자 정보 관리 Request DTO","properties":{"jobGrpCd":{"type":"string","description":"업무 그룹 코드","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"userId":{"type":"string","description":"사용자 아이디"},"userNm":{"type":"string","description":"사용자 아이디"},"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"userInfoSearchTgt":{"type":"string","description":"사용자 정보 검색 타입"},"userInfo":{"type":"string","description":"사용자 정보(이름 or 아이디)"},"workStatCd":{"type":"string","description":"근무상태코드(UR004)"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"pwdLockYn":{"type":"string","description":"계정 잠김 여부"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"}}},"ResponseRealGridListResponseUserListResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/RealGridListResponseUserListResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseUserListResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/UserListResponse"}}}},"UserListResponse":{"type":"object","description":"사용자 정보 관리 Response DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"userNm":{"type":"string","description":"사용자명"},"rcntUseDtm":{"type":"string","description":"최근 사용 일시"},"orgTypNm":{"type":"string","description":"업무 그룹 코드(UR002)","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"deptNm":{"type":"string","description":"부서명"},"ocpNm":{"type":"string","description":"직책 코드(UR003)"},"workStatNm":{"type":"string","description":"근무 상태 코드(UR004)"},"pwdLockYn":{"type":"string","description":"계정 잠김 여부"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"useYn":{"type":"string","description":"사용여부"},"sysGbCdNm":{"type":"string","description":"시스템구분명"},"rtGrpNm":{"type":"string","description":"권한그룹명"},"totalCount":{"type":"integer","format":"int32","description":"목록 수"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/system/userMgmt":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.\n","operationId":"getUserListInUserMenu","parameters":[{"name":"userListRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserListRequest"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"jobGrpCd","in":"query","description":"업무 그룹 코드","schema":{"type":"string"}},{"name":"userInfoSearchTgt","in":"query","description":"사용자 정보 검색 타입","schema":{"type":"string"}},{"name":"userInfo","in":"query","description":"사용자 정보(이름 or 아이디)","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"사용여부","schema":{"type":"string"}},{"name":"workStatCd","in":"query","description":"부서코드","schema":{"type":"string"}},{"name":"indInfoDealYn","in":"query","description":"근무상태코드","schema":{"type":"string"}},{"name":"pwdLockYn","in":"query","description":"계정 잠김 여부","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseUserListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 저장
> \## 기능설명\
> \* 사용자 정보를 저장합니다.\
> \---\
> \## 상세설명\
> \* 사용자를 새로 등록하거나 기존 사용자 정보를 수정합니다.\
> \* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다\
> \* 필수 값 목록\
> \* 사용자 아이디\
> \* 사용자 이름\
> \* 휴대폰 번호\
> \* 권한 그룹 번호\
> \* 이메일 주소\
> \* 업무 그룹 코드\
> \* 직책 코드\
> \* 근무 상태 코드
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UserDetailRequest":{"type":"object","description":"사용자 저장 Request DTO","properties":{"userInfo":{"$ref":"#/components/schemas/UserCudRequest","description":"사용자 정보"},"individualInfoRightList":{"type":"array","description":"개인정보취급권한","items":{"$ref":"#/components/schemas/IndividualInfoRightCudRequest"}},"changeRtGrpNoYn":{"type":"string","description":"권한그룹 변경 여부","minLength":1},"createYn":{"type":"string","description":"신규 등록 여부","minLength":1},"beforeRtGrpNo":{"type":"string","description":"변경전 권한그룹번호"},"rtGrpChgCausCont":{"type":"string"}},"required":["changeRtGrpNoYn","createYn"]},"UserCudRequest":{"type":"object","description":"사용자 수정 Request DTO","properties":{"userId":{"type":"string","description":"사용자 아이디","minLength":1},"userNm":{"type":"string","description":"사용자명","minLength":1},"empNo":{"type":"string","description":"사번"},"pwd":{"type":"string","description":"비밀번호"},"userGbCd":{"type":"string","description":"사용자 구분 코드(UR001)","minLength":1},"rtGrpNo":{"type":"string","description":"권한 그룹 번호","minLength":1},"jobGrpCd":{"type":"string","description":"업무 그룹 코드","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"],"minLength":1},"ocpCd":{"type":"string","description":"조직 역할 코드(UR003)","minLength":1},"workStatCd":{"type":"string","description":"근무 상태 코드(UR004)","minLength":1},"deptCd":{"type":"string","description":"부서코드"},"entrNo":{"type":"string","description":"협력사 번호"},"telRgnNo":{"type":"string","description":"전화 지역 번호"},"telTxnoNo":{"type":"string","description":"전화 국번 번호"},"telEndNo":{"type":"string","description":"전화 끝 번호"},"cellSctNo":{"type":"string","description":"휴대폰 구분 번호","minLength":1},"cellTxnoNo":{"type":"string","description":"휴대폰 국번 번호","minLength":1},"cellEndNo":{"type":"string","description":"휴대폰 끝 번호","minLength":1},"cnslEntpNm":{"type":"string","description":"상담 업체명"},"ctiNo":{"type":"string","description":"CTI 번호"},"itelNo":{"type":"string","description":"내선번호"},"emailAddr":{"type":"string","description":"이메일 주소","minLength":1},"indInfoDealYn":{"type":"string","description":"개인정보취급여부","minLength":1},"useYn":{"type":"string","description":"사용여부","minLength":1},"atchFileRouteNm":{"type":"string","description":"첨부파일경로명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부파일명(현재 미사용)"},"indInfoDealCausCont":{"type":"string","description":"개인정보취급사유내용"},"userIpAddr":{"type":"string","description":"접근허용 IP"}},"required":["cellEndNo","cellSctNo","cellTxnoNo","emailAddr","indInfoDealYn","jobGrpCd","ocpCd","rtGrpNo","useYn","userGbCd","userId","userNm","workStatCd"]},"IndividualInfoRightCudRequest":{"type":"object","properties":{"userId":{"type":"string","minLength":1},"indInfoGbCd":{"type":"string","minLength":1},"useYn":{"type":"string","minLength":1}},"required":["indInfoGbCd","useYn","userId"]},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/system/userMgmt":{"post":{"tags":["사용자 정보 관리"],"summary":"사용자 저장","description":"## 기능설명\n* 사용자 정보를 저장합니다.\n---\n## 상세설명\n* 사용자를 새로 등록하거나 기존 사용자 정보를 수정합니다.\n* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다\n* 필수 값 목록\n * 사용자 아이디\n * 사용자 이름\n * 휴대폰 번호\n * 권한 그룹 번호\n * 이메일 주소\n * 업무 그룹 코드\n * 직책 코드\n * 근무 상태 코드\n","operationId":"saveUser","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDetailRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 비밀번호 초기화
> \## 기능설명\
> \* 사용자의 비밀번호를 초기화합니다.\
> \---\
> \## 상세설명\
> \* 비밀번호는 랜덤한 값으로 변경됩니다.\
> \* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/system/userMgmt/{userId}/password/reset":{"post":{"tags":["사용자 정보 관리"],"summary":"비밀번호 초기화","description":"## 기능설명\n* 사용자의 비밀번호를 초기화합니다.\n---\n## 상세설명\n* 비밀번호는 랜덤한 값으로 변경됩니다.\n* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다\n","operationId":"modifyInitializePassword","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 비밀번호 초기화
> \## 기능설명\
> \* 사용자의 비밀번호를 초기화합니다.\
> \---\
> \## 상세설명\
> \* 비밀번호는 랜덤한 값으로 변경됩니다.\
> \* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/userMgmt/modifyInitializePassword":{"post":{"tags":["사용자 정보 관리"],"summary":"비밀번호 초기화","description":"## 기능설명\n* 사용자의 비밀번호를 초기화합니다.\n---\n## 상세설명\n* 비밀번호는 랜덤한 값으로 변경됩니다.\n* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다\n","operationId":"modifyInitializePassword_1","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 비밀번호 잠김 해제
> \## 기능설명\
> \* 비밀번호가 잠김을 해제 처리합니다.\
> \---\
> \## 상세설명\
> \* 비밀번호가 잠겨있는 사용자의 대해 비밀번호 잠김을 해제합니다.\
> \* 비밀번호 실패횟수를 0으로 초기화합니다.\
> \* 업데이트된 사용자 정보를 반환합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UserDetailResponse":{"type":"object","description":"사용자 정보 Response DTO","properties":{"userInfo":{"$ref":"#/components/schemas/StUserBase","description":"사용자 정보"},"individualInfoRightList":{"type":"array","description":"개인정보 취급 권한","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}}}},"StUserBase":{"type":"object","description":"사용자 정보 Entity","properties":{"userId":{"type":"string","description":"사용자 아이디"},"userGbCd":{"type":"string","description":"사용자 구분 코드(UR001)"},"deptCd":{"type":"string","description":"부서코드"},"deptNm":{"type":"string","description":"부서명"},"entrNo":{"type":"string","description":"협력사 번호"},"entrNm":{"type":"string","description":"협력사 명"},"userNm":{"type":"string","description":"사용자명"},"pwd":{"type":"string","description":"비밀번호"},"sysGbCd":{"type":"string","description":"시스템 그룹 번호"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹 명"},"useYn":{"type":"string","description":"사용여부"},"telRgnNo":{"type":"string","description":"전화 지역 번호"},"telTxnoNo":{"type":"string","description":"전화 국번 번호"},"telEndNo":{"type":"string","description":"전화 끝 번호"},"cellSctNo":{"type":"string","description":"휴대폰 구분 번호"},"cellTxnoNo":{"type":"string","description":"휴대폰 국번 번호"},"cellEndNo":{"type":"string","description":"휴대폰 끝 번호"},"emailAddr":{"type":"string","description":"이메일 주소"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"indInfoDealCausCont":{"type":"string","description":"개인 정보 취급 사유 내용"},"empNo":{"type":"string","description":"사원번호"},"jobGrpCd":{"type":"string","description":"업무 그룹 코드(UR002)","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"ocpCd":{"type":"string","description":"직책코드(UR003)"},"workStatCd":{"type":"string","description":"근무 상태코드(UR004)"},"atchFileRouteNm":{"type":"string","description":"첨부 파일 경로 명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부 파일명(현재 미사용)"},"useStrtDt":{"type":"string","description":"사용 시작 일자"},"useEndDt":{"type":"string","description":"사용 종료 일자"},"cnslEntpNm":{"type":"string","description":"상담 업체명"},"itelNo":{"type":"string","description":"내선번호"},"ctiNo":{"type":"string","description":"CTI번호"},"rcntUseDtm":{"type":"string","format":"date-time","description":"최근 사용 일시"},"pwdLockRvcmnId":{"type":"string","description":"잠김 해제 처리지"},"pwdLockRvcDtm":{"type":"string","format":"date-time","description":"잠김 해제 처리 일시"},"pwdCntnFailCnt":{"type":"integer","format":"int64","description":"비밀번호 연속 실패 수"},"lstPwdChgDtm":{"type":"string","format":"date-time","description":"최종 비밀번호 변경 일시"},"pwdLockYn":{"type":"string","description":"비밀번호 잠김 여부"},"pwdIniYn":{"type":"string","description":"비밀번호 초기화 여부"},"userIpAddr":{"type":"string","description":"접근허용 IP"}}},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/userMgmt/modifyUpdatePwdUnlock":{"get":{"tags":["사용자 정보 관리"],"summary":"비밀번호 잠김 해제","description":"## 기능설명\n* 비밀번호가 잠김을 해제 처리합니다.\n---\n## 상세설명\n* 비밀번호가 잠겨있는 사용자의 대해 비밀번호 잠김을 해제합니다.\n* 비밀번호 실패횟수를 0으로 초기화합니다.\n* 업데이트된 사용자 정보를 반환합니다.\n","operationId":"modifyUpdatePwdUnlock","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UserDetailResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 권한그룹 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240927 : 사용자 권한그룹 목록 조회 v2 신규 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UserRightGroupRequest":{"type":"object","description":"권한 그룹 조회 Request DTO","properties":{"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹명"},"argSelectType":{"type":"string","description":"선택구분"}}},"RealGridListResponseUserRightGroupResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/UserRightGroupResponse"}}}},"UserRightGroupResponse":{"type":"object","description":"권한그룹 정보 Response DTO","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"sysGbNm":{"type":"string","description":"시스템구분명"},"rtGrpNm":{"type":"string","description":"권한그룹명"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/userMgmt/getUserRightGroupInfo":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 권한그룹 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n---\n## 수정번호\n* Release v2.00_240927 : 사용자 권한그룹 목록 조회 v2 신규 생성\n","operationId":"getUserRightGroupInfo","parameters":[{"name":"userRightGroupRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserRightGroupRequest"}},{"name":"sysGbCd","in":"query","description":"사스템 구분 코드","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한 그룹명","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseUserRightGroupResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 상세 조회
> \## 기능설명\
> \* 사용자의 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 현재 로그인한 사용자의 정보를 조회합니다.\
> \* 현재 로그인한 사용자의 개인정보 취급권한 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseUserDetailResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/UserDetailResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"UserDetailResponse":{"type":"object","description":"사용자 정보 Response DTO","properties":{"userInfo":{"$ref":"#/components/schemas/StUserBase","description":"사용자 정보"},"individualInfoRightList":{"type":"array","description":"개인정보 취급 권한","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}}}},"StUserBase":{"type":"object","description":"사용자 정보 Entity","properties":{"userId":{"type":"string","description":"사용자 아이디"},"userGbCd":{"type":"string","description":"사용자 구분 코드(UR001)"},"deptCd":{"type":"string","description":"부서코드"},"deptNm":{"type":"string","description":"부서명"},"entrNo":{"type":"string","description":"협력사 번호"},"entrNm":{"type":"string","description":"협력사 명"},"userNm":{"type":"string","description":"사용자명"},"pwd":{"type":"string","description":"비밀번호"},"sysGbCd":{"type":"string","description":"시스템 그룹 번호"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹 명"},"useYn":{"type":"string","description":"사용여부"},"telRgnNo":{"type":"string","description":"전화 지역 번호"},"telTxnoNo":{"type":"string","description":"전화 국번 번호"},"telEndNo":{"type":"string","description":"전화 끝 번호"},"cellSctNo":{"type":"string","description":"휴대폰 구분 번호"},"cellTxnoNo":{"type":"string","description":"휴대폰 국번 번호"},"cellEndNo":{"type":"string","description":"휴대폰 끝 번호"},"emailAddr":{"type":"string","description":"이메일 주소"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"indInfoDealCausCont":{"type":"string","description":"개인 정보 취급 사유 내용"},"empNo":{"type":"string","description":"사원번호"},"jobGrpCd":{"type":"string","description":"업무 그룹 코드(UR002)","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"ocpCd":{"type":"string","description":"직책코드(UR003)"},"workStatCd":{"type":"string","description":"근무 상태코드(UR004)"},"atchFileRouteNm":{"type":"string","description":"첨부 파일 경로 명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부 파일명(현재 미사용)"},"useStrtDt":{"type":"string","description":"사용 시작 일자"},"useEndDt":{"type":"string","description":"사용 종료 일자"},"cnslEntpNm":{"type":"string","description":"상담 업체명"},"itelNo":{"type":"string","description":"내선번호"},"ctiNo":{"type":"string","description":"CTI번호"},"rcntUseDtm":{"type":"string","format":"date-time","description":"최근 사용 일시"},"pwdLockRvcmnId":{"type":"string","description":"잠김 해제 처리지"},"pwdLockRvcDtm":{"type":"string","format":"date-time","description":"잠김 해제 처리 일시"},"pwdCntnFailCnt":{"type":"integer","format":"int64","description":"비밀번호 연속 실패 수"},"lstPwdChgDtm":{"type":"string","format":"date-time","description":"최종 비밀번호 변경 일시"},"pwdLockYn":{"type":"string","description":"비밀번호 잠김 여부"},"pwdIniYn":{"type":"string","description":"비밀번호 초기화 여부"},"userIpAddr":{"type":"string","description":"접근허용 IP"}}},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/system/userMgmt/detail":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 상세 조회","description":"## 기능설명\n* 사용자의 정보를 조회합니다.\n---\n## 상세설명\n* 현재 로그인한 사용자의 정보를 조회합니다.\n* 현재 로그인한 사용자의 개인정보 취급권한 조회합니다.\n","operationId":"getUserDetail","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseUserDetailResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 아이디 중복체크
> \## 기능설명\
> \* 사용자 아이디 개수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 파라미터 값과 현재 저장되어 있는 사용자 아이디를 비교하여 일치하는 개수를 반환합니다.\
> \* 아이디 중복 체크를 위해 사용됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseInteger":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"integer","format":"int32","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/system/userMgmt/check":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 아이디 중복체크","description":"## 기능설명\n* 사용자 아이디 개수를 조회합니다.\n---\n## 상세설명\n* 파라미터 값과 현재 저장되어 있는 사용자 아이디를 비교하여 일치하는 개수를 반환합니다.\n* 아이디 중복 체크를 위해 사용됩니다.\n","operationId":"getCheckUserId","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseInteger"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 권한그룹 목록 건수 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록 건수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록 건수를 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UserRightGroupRequest":{"type":"object","description":"권한 그룹 조회 Request DTO","properties":{"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹명"},"argSelectType":{"type":"string","description":"선택구분"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/userMgmt/getUserRightGroupListCount":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 권한그룹 목록 건수 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록 건수를 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록 건수를 조회합니다.\n","operationId":"getUserRightGroupListCount","parameters":[{"name":"userRightGroupRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserRightGroupRequest"}},{"name":"sysGbCd","in":"query","description":"사스템 구분 코드","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한 그룹명","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 권한그룹 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UserRightGroupRequest":{"type":"object","description":"권한 그룹 조회 Request DTO","properties":{"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹명"},"argSelectType":{"type":"string","description":"선택구분"}}},"UserRightGroupResponse":{"type":"object","description":"권한그룹 정보 Response DTO","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"sysGbNm":{"type":"string","description":"시스템구분명"},"rtGrpNm":{"type":"string","description":"권한그룹명"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/userMgmt/getUserRightGroupInfo":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 권한그룹 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n","operationId":"getUserRightGroupInfo_1","parameters":[{"name":"userRightGroupRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserRightGroupRequest"}},{"name":"sysGbCd","in":"query","description":"사스템 구분 코드","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한 그룹명","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserRightGroupResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 목록 수 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 사용자 목록 건수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 사용자 목록 건수를 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UserListRequest":{"type":"object","description":"사용자 정보 관리 Request DTO","properties":{"jobGrpCd":{"type":"string","description":"업무 그룹 코드","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"userId":{"type":"string","description":"사용자 아이디"},"userNm":{"type":"string","description":"사용자 아이디"},"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"userInfoSearchTgt":{"type":"string","description":"사용자 정보 검색 타입"},"userInfo":{"type":"string","description":"사용자 정보(이름 or 아이디)"},"workStatCd":{"type":"string","description":"근무상태코드(UR004)"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"pwdLockYn":{"type":"string","description":"계정 잠김 여부"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/userMgmt/getUserListInUserMenuCount":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 목록 수 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 사용자 목록 건수를 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 사용자 목록 건수를 조회합니다.\n","operationId":"getUserListInUserMenuCount","parameters":[{"name":"userListRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserListRequest"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"jobGrpCd","in":"query","description":"업무 그룹 코드","schema":{"type":"string"}},{"name":"userInfoSearchTgt","in":"query","description":"사용자 정보 검색 타입","schema":{"type":"string"}},{"name":"userInfo","in":"query","description":"사용자 정보(이름 or 아이디)","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"사용여부","schema":{"type":"string"}},{"name":"workStatCd","in":"query","description":"부서코드","schema":{"type":"string"}},{"name":"indInfoDealYn","in":"query","description":"근무상태코드","schema":{"type":"string"}},{"name":"pwdLockYn","in":"query","description":"계정 잠김 여부","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 개인정보 취급권한 조회
> \## 기능설명\
> \* 사용자의 개인정보 취급권한 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 현재 로그인한 사용자의 개인정보 취급권한 목록을 조회합니다.\
> \* 사용 여부가 Y인 목록을 조회합니다.\
> \--\
> \## 수정번호\
> \* Release v2.00\_240912: 최초 개발
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PrivacyPolicyInfoV2":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/userMgmt/getIndividualInfoRightList":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 개인정보 취급권한 조회","description":"## 기능설명\n* 사용자의 개인정보 취급권한 목록을 조회합니다.\n---\n## 상세설명\n* 현재 로그인한 사용자의 개인정보 취급권한 목록을 조회합니다.\n* 사용 여부가 Y인 목록을 조회합니다.\n--\n## 수정번호\n* Release v2.00_240912: 최초 개발\n","operationId":"getIndividualInfoRightList","responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrivacyPolicyInfoV2"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-5.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.