> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-9.md).
# 개별 권한 관리
## 개별 권한 저장
> \## 기능설명\
> \* 개별권한을 등록, 수정합니다.\
> \---\
> \## 상세설명\
> \* 기존 사용자는 수정, 신규 사용자는 등록이 진행됩니다.\
> \* 등록\
> \* 이미 개별권한을 갖고 있는 사용자는 등록이 불가합니다.\
> \* 팔수 값 목록\
> \* 유저 아이디\
> \* 적용 시작 일자\
> \* 적용 종료 일자\
> \* 수정\
> \* 필수 값 목록\
> \* 개별권한번호\
> \* 유저 아이디\
> \* 적용 시작 일자\
> \* 적용 종료 일자\
> \---\
> \## 수정번호\
> \* Release v2.00\_240617: 개별 권한 등록 적용 시작 일자, 적용 종료 일자 수정
```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":{"RealGridCUDRequestStIndivRtBaseInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StIndivRtBaseInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StIndivRtBaseInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StIndivRtBaseInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StIndivRtBaseInfo"}}}},"StIndivRtBaseInfo":{"type":"object","description":"권한 대상 기본 Entity","properties":{"indivRtNo":{"type":"string","description":"개별권한번호"},"userId":{"type":"string","description":"사용자 아이디"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"useYn":{"type":"string","description":"사용여부"},"regCausCont":{"type":"string","description":"등록사유내용"},"atchFileRouteNm":{"type":"string","description":"첨부파일경로명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부파일명(현재 미사용)"},"rtGrpNm":{"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/individualRightMgmt/saveIndividualRightList":{"post":{"tags":["개별 권한 관리"],"summary":"개별 권한 저장","description":"## 기능설명\n* 개별권한을 등록, 수정합니다.\n---\n## 상세설명\n* 기존 사용자는 수정, 신규 사용자는 등록이 진행됩니다.\n* 등록\n * 이미 개별권한을 갖고 있는 사용자는 등록이 불가합니다.\n * 팔수 값 목록\n * 유저 아이디\n * 적용 시작 일자\n * 적용 종료 일자\n* 수정\n * 필수 값 목록\n * 개별권한번호\n * 유저 아이디\n * 적용 시작 일자\n * 적용 종료 일자\n---\n## 수정번호\n* Release v2.00_240617: 개별 권한 등록 적용 시작 일자, 적용 종료 일자 수정\n","operationId":"saveIndividualRightList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStIndivRtBaseInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"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":{"RealGridCUDRequestStRtInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StRtInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StRtInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StRtInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StRtInfo"}}}},"StRtInfo":{"type":"object","description":"권한 정보 Entity","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtSubGbCd":{"type":"string","description":"권한주체구분코드(UR006)"},"useYn":{"type":"string","description":"사용여부"},"groupYn":{"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/individualRightMgmt/saveIndividualRightButtonGridList":{"post":{"tags":["개별 권한 관리"],"summary":"버튼 권한 저장","description":"## 기능설명\n* 버튼권한을 수정합니다.\n---\n## 상세설명\n* 사용자의 개별 개별 메뉴권한에 버튼권한 정보를 수정합니다.\n* 버튼권한 등록은 불가합니다.\n","operationId":"saveIndividualRightButtonGridList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStRtInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"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":{"IndividualRtInfoRequest":{"type":"object","properties":{"userId":{"type":"string"},"rtGrpNm":{"type":"string"},"rtGrpNo":{"type":"string"},"useYn":{"type":"string"}}},"RealGridListResponseIndividualRtInfoResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/IndividualRtInfoResponse"}}}},"IndividualRtInfoResponse":{"type":"object","description":"개별 권한 Response DTO","properties":{"indivRtNo":{"type":"string","description":"개별권한번호"},"userId":{"type":"string","description":"사용자 아이디"},"userNm":{"type":"string","description":"사용자 이름"},"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"sysGbCdNm":{"type":"string","description":"시스템 구분 코드명"},"rtGrpNm":{"type":"string","description":"권한그룹명"},"rtGrpNo":{"type":"string","description":"권한그룹번호"},"regCausCont":{"type":"string","description":"등록사유"},"aplyStrDt":{"type":"string","description":"적용 시작 일자"},"aplyEndDt":{"type":"string","description":"적용 종료 일자"},"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/individualRightMgmt/getIndividualRightList":{"get":{"tags":["개별 권한 관리"],"summary":"개별 권한 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 개별 권한 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 개별 권한 목록을 조회합니다.\n","operationId":"getIndividualRightList","parameters":[{"name":"individualRtInfoRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/IndividualRtInfoRequest"}},{"name":"userId","in":"query","description":"사용자 아이디","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한그룹명","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseIndividualRtInfoResponse"}}}},"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":{"RtTargetBaseRequest":{"type":"object","properties":{"sysGbCd":{"type":"string"},"rtTgtSeq":{"type":"string"},"uprRtTgtSeq":{"type":"string"},"userId":{"type":"string"},"rtGrpNo":{"type":"string"},"rtSubGbCd":{"type":"string"},"indivRtNo":{"type":"string"},"useYn":{"type":"string"}}},"ResponseListRtTargetBaseResponse":{"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":"array","description":"payload","items":{"$ref":"#/components/schemas/RtTargetBaseResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RtTargetBaseResponse":{"type":"object","description":"메뉴 권한 Response DTO","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"type":"string","description":"팝업여부"},"level":{"type":"string","description":"레벨"},"hierarchy":{"type":"string","description":"트리 분류"},"uprRtTgtNm":{"type":"string","description":"상위권한대상명"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"callUrl":{"type":"string","description":"호출 URL"},"httpMethod":{"type":"string","description":"호출 URL"},"useYn":{"type":"string","description":"사용여부"},"rtSubGbCd":{"type":"string","description":"권한주체구분코드(UR006)"},"groupYn":{"type":"string","description":"그룹 권한 사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"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/individualRightMgmt/getIndividualMenuTreeList":{"get":{"tags":["개별 권한 관리"],"summary":"메뉴 권한 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 사용자에 대한 메뉴 권한 목록을 조회합니다.\n---\n## 상세설명\n* 메뉴 권한 목록은 트리 구조로 조회됩니다.\n* 개별권한기본정보 테이블에만 데이터 존재하고 권한정보엔 없는 상태는 권한대상기본에서 모든 메뉴 조회합니다.\n","operationId":"getIndividualMenuTreeList","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"rtSubGbCd","in":"query","description":"권한주체구분코드(UR006)","schema":{"type":"string"}},{"name":"rtGrpNo","in":"query","description":"권한그룹번호","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListRtTargetBaseResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```