# 권한 그룹 관리 ## 권한 그룹 버튼권한 저장 > \## 기능설명\ > \* 화면에서 선택한 메뉴 권한의 버튼권한 저장합니다.\ > \---\ > \## 상세설명\ > \* 화면에서 선택한 메뉴 권한의 버튼권한 저장합니다.
```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"}}}}}}}}} ``` --- # 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-7.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.