> 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-7.md).
# 권한 그룹 관리
## 권한 그룹 버튼권한 저장
> \## 기능설명\
> \* 화면에서 선택한 메뉴 권한의 버튼권한 저장합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 메뉴 권한의 버튼권한 저장합니다.
```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":{"RightTargetBaseMenuRequest":{"type":"object","description":"권한 그룹 버튼 Request DTO","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"rootRtGrpNo":{"type":"string","description":"최상위 권한그룹번호"},"rtTgtSeq":{"type":"string","description":"권한 대상 순번"},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"rtSubGbCd":{"type":"string","description":"권한주체 구분코드(UR006)"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"uprRtTgtSeq":{"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/rightGroupMgmt/saveRightTargetBaseMenu":{"post":{"tags":["권한 그룹 관리"],"summary":"권한 그룹 버튼권한 저장","description":"## 기능설명\n* 화면에서 선택한 메뉴 권한의 버튼권한 저장합니다.\n---\n## 상세설명\n* 화면에서 선택한 메뉴 권한의 버튼권한 저장합니다.\n","operationId":"saveRightTargetBaseMenu","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RightTargetBaseMenuRequest"}}}},"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":{"RealGridCUDRequestRightGroupBaseRequest":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseRequest"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseRequest"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseRequest"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseRequest"}}}},"RightGroupBaseRequest":{"type":"object","properties":{"rtGrpNo":{"type":"string"},"sysGbCd":{"type":"string"},"rtGrpNm":{"type":"string"},"aplyStrDt":{"type":"string"},"aplyEndDt":{"type":"string"},"useYn":{"type":"string"}}},"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/rightGroupMgmt/saveRightGroupBaseList":{"post":{"tags":["권한 그룹 관리"],"summary":"권한 그룹 저장","description":"## 기능설명\n* 권한 그룹 정보를 등록, 수정, 삭제합니다.\n---\n## 상세설명\n* 화면에 그리드에서 등록, 수정, 삭제 정보를 한번에 넘겨받아 처리합니다.\n* 필수 값 목록\n * 권한 그룹 번호\n * 권한 그룹 명\n * 시스템 구분 코드\n * 적용 시작 일자\n * 적용 종료 일자\n * 사용 여부\n * 수성 처리자 아이디\n","operationId":"saveRightGroupBaseList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestRightGroupBaseRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 대시보드 권한그룹 조회
> \## 기능설명\
> \* 대시보드 권한그룹을 조회합니다.\
> \---\
> \## 상세설명\
> \* 권한대상순번 혹은 호출URL 로 권한 정보를 조회합니다.\
> \* 시스템구분코드는 필수입니다.\
> \* 조회할 권한의 권한대상순번이나 호출URL 둘 중 하나는 필수입니다.\
> \* 호출URL로 조회 시 시스템구분코드에 맞는 권한 정보를 반환합니다.\
> \* 응답 파라미터의 menuKey는 권한대상순번, '-', 상위권한대상순번 으로 조합됩니다.
```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":{"StRtTgtBase":{"type":"object","description":"권한대상기본","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"rtTgtNm":{"type":"string","description":"권한대상명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"callUrl":{"type":"string","description":"호출URL"},"useYn":{"type":"string","description":"사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"popupYn":{"type":"string","description":"팝업여부"},"btnId":{"type":"string","description":"버튼ID"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"leafMenuYn":{"type":"string","description":"최하위메뉴여부"},"userHelpCont":{"type":"string","description":"사용자도움말내용"}}},"DashBoardLinkResponse":{"type":"object","description":"대시보드 권한그룹 Response DTO","properties":{"menuKey":{"type":"string","description":"메뉴키"},"rtTgtNm":{"type":"string","description":"권한그룹명"},"callUrl":{"type":"string","description":"호출 URL"},"rtTgtSeq":{"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/rightGroupMgmt/getRtInfo":{"get":{"tags":["권한 그룹 관리"],"summary":"대시보드 권한그룹 조회","description":"## 기능설명\n* 대시보드 권한그룹을 조회합니다.\n---\n## 상세설명\n* 권한대상순번 혹은 호출URL 로 권한 정보를 조회합니다.\n* 시스템구분코드는 필수입니다.\n* 조회할 권한의 권한대상순번이나 호출URL 둘 중 하나는 필수입니다.\n* 호출URL로 조회 시 시스템구분코드에 맞는 권한 정보를 반환합니다.\n* 응답 파라미터의 menuKey는 권한대상순번, '-', 상위권한대상순번 으로 조합됩니다.\n","operationId":"getRtInfo","parameters":[{"name":"stRtTgtBase","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StRtTgtBase"}},{"name":"rtTgtSeq","in":"query","description":"권한대상순번","schema":{"type":"string"}},{"name":"callUrl","in":"query","description":"호출 URL","schema":{"type":"string"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DashBoardLinkResponse"}}}},"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":{"RightTargetBaseMenuRequest":{"type":"object","description":"권한 그룹 버튼 Request DTO","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"rootRtGrpNo":{"type":"string","description":"최상위 권한그룹번호"},"rtTgtSeq":{"type":"string","description":"권한 대상 순번"},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"rtSubGbCd":{"type":"string","description":"권한주체 구분코드(UR006)"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"}}},"RightTargetBaseMenuResponse":{"type":"object","description":"권한그룹 버튼 목록 Response DTO","properties":{"rtGrpNo":{"type":"string","description":"권한번호"},"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"권한그룹명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"popupYn":{"type":"string","description":"팝업여부"},"level":{"type":"string","description":"레벨"},"hierarchy":{"type":"string","description":"Tree 계층을 위한 변수"},"groupYn":{"type":"string","description":"그룹 권한 사용여부"},"rtSubGbCd":{"type":"string","description":"권한주체구분코드(UR006)"}}},"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/rightGroupMgmt/getRightGroupButtonList":{"get":{"tags":["권한 그룹 관리"],"summary":"권한 그룹 버튼 목록 조회","description":"## 기능설명\n* 화면에서 권한 그룹 메뉴의 버튼 목록을 조회합니다.\n---\n## 상세설명\n* 필수 값 목록\n * 권한 대상 순번\n * 시스템 구분 코드\n","operationId":"getRightGroupButtonList","parameters":[{"name":"stRtTgtMenuRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RightTargetBaseMenuRequest"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"rtTgtSeq","in":"query","description":"권한대상순번","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RightTargetBaseMenuResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 권한 그룹 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_241014 : 권한 그룹 목록 조회 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":{"RightGroupBaseRequest":{"type":"object","properties":{"rtGrpNo":{"type":"string"},"sysGbCd":{"type":"string"},"rtGrpNm":{"type":"string"},"aplyStrDt":{"type":"string"},"aplyEndDt":{"type":"string"},"useYn":{"type":"string"}}},"RealGridListResponseRightGroupBaseResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseResponse"}}}},"RightGroupBaseResponse":{"type":"object","properties":{"rtGrpNo":{"type":"string"},"sysGbCd":{"type":"string"},"rtGrpNm":{"type":"string"},"aplyStrDt":{"type":"string"},"aplyEndDt":{"type":"string"},"useYn":{"type":"string"}}},"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/rightGroupMgmt/getRightGroupBaseList":{"get":{"tags":["권한 그룹 관리"],"summary":"권한 그룹 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n---\n## 수정번호\n* Release v2.00_241014 : 권한 그룹 목록 조회 V2\n","operationId":"getRightGroupBaseList","parameters":[{"name":"rightGroupBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RightGroupBaseRequest"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"rtGrpNo","in":"query","description":"권한그룹번호","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한그룹명","schema":{"type":"string"}},{"name":"useYn","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/RealGridListResponseRightGroupBaseResponse"}}}},"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":{"RightTargetBaseMenuRequest":{"type":"object","description":"권한 그룹 버튼 Request DTO","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"rootRtGrpNo":{"type":"string","description":"최상위 권한그룹번호"},"rtTgtSeq":{"type":"string","description":"권한 대상 순번"},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"rtSubGbCd":{"type":"string","description":"권한주체 구분코드(UR006)"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"}}},"RightTargetBaseMenuResponse":{"type":"object","description":"권한그룹 버튼 목록 Response DTO","properties":{"rtGrpNo":{"type":"string","description":"권한번호"},"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"권한그룹명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"popupYn":{"type":"string","description":"팝업여부"},"level":{"type":"string","description":"레벨"},"hierarchy":{"type":"string","description":"Tree 계층을 위한 변수"},"groupYn":{"type":"string","description":"그룹 권한 사용여부"},"rtSubGbCd":{"type":"string","description":"권한주체구분코드(UR006)"}}},"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/rightGroupMgmt/getIndivRightButtonList":{"get":{"tags":["권한 그룹 관리"],"summary":"개별 권한 버튼 목록 조회","description":"## 기능설명\n* 화면에서 개별 권한 메뉴의 버튼 목록을 조회합니다.\n---\n## 상세설명\n* 필수 값 목록\n * 권한 대상 순번\n * 시스템 구분 코드\n * 권한그룹번호\n * 최상위 권한그룹번호\n","operationId":"getIndivRightButtonList","parameters":[{"name":"stRtTgtMenuRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RightTargetBaseMenuRequest"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"rtTgtSeq","in":"query","description":"권한대상순번","schema":{"type":"string"}},{"name":"rtGrpNo","in":"query","description":"권한그룹번호","schema":{"type":"string"}},{"name":"rootRtGrpNo","in":"query","description":"최상위 권한그룹번호","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RightTargetBaseMenuResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```