> 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.md).

# 메뉴 정보 관리

## 메뉴 상세 정보 조회

> \## 기능설명\
> \* 화면에서 클릭한 메뉴의 샹세 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 클릭한 메뉴의 샹세 정보를 조회합니다.<br>

```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":{"AuthTargetBase":{"type":"object","description":"권한대상기본","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"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":"호출 Method"},"useYn":{"type":"string","description":"사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"type":"string","description":"사용자 도움말 내용"},"totalCount":{"type":"integer","format":"int32","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/menuMgmt/{rtTgtSeq}":{"get":{"tags":["메뉴 정보 관리"],"summary":"메뉴 상세 정보 조회","description":"## 기능설명\n* 화면에서 클릭한 메뉴의 샹세 정보를 조회합니다.\n---\n## 상세설명\n* 화면에서 클릭한 메뉴의 샹세 정보를 조회합니다.\n","operationId":"getMenu","parameters":[{"name":"rtTgtSeq","in":"path","description":"권한대상순번","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AuthTargetBase"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 하위 메뉴 목록 저장

> \## 기능설명\
> \* 메뉴 목록을 등록, 수정, 삭제합니다.\
> \---\
> \## 상세설명\
> \* 필수 값 목록\
> &#x20;  \* 저장\
> &#x20;     \* 권한대상명\
> &#x20;     \* 권한대상유형코드\
> &#x20;     \* 정렬순서\
> &#x20;     \* 사용여부\
> &#x20;     \* 시스템구분코드\
> &#x20;     \* 상위권한대상순번\
> &#x20;     \* 시스템등록자아이디\
> &#x20;     \* 시스템수정자아이디\
> &#x20;  \* 수정\
> &#x20;     \* 권한대상순번\
> &#x20;     \* 권한대상명\
> &#x20;     \* 정렬순서\
> &#x20;     \* 사용여부\
> &#x20;     \* 시스템등록자아이디\
> &#x20;     \* 시스템수정자아이디\
> &#x20;  \* 삭제\
> &#x20;     \* 권한대상순번<br>

```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":{"RealGridCUDRequestAuthTargetBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/AuthTargetBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/AuthTargetBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/AuthTargetBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/AuthTargetBase"}}}},"AuthTargetBase":{"type":"object","description":"권한대상기본","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"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":"호출 Method"},"useYn":{"type":"string","description":"사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"type":"string","description":"사용자 도움말 내용"},"totalCount":{"type":"integer","format":"int32","description":"총 갯수"}}},"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/menuMgmt/{rtTgtSeq}":{"post":{"tags":["메뉴 정보 관리"],"summary":"하위 메뉴 목록 저장","description":"## 기능설명\n* 메뉴 목록을 등록, 수정, 삭제합니다.\n---\n## 상세설명\n* 필수 값 목록\n   * 저장\n      * 권한대상명\n      * 권한대상유형코드\n      * 정렬순서\n      * 사용여부\n      * 시스템구분코드\n      * 상위권한대상순번\n      * 시스템등록자아이디\n      * 시스템수정자아이디\n   * 수정\n      * 권한대상순번\n      * 권한대상명\n      * 정렬순서\n      * 사용여부\n      * 시스템등록자아이디\n      * 시스템수정자아이디\n   * 삭제\n      * 권한대상순번\n","operationId":"saveMeuList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestAuthTargetBase"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴 상세정보 수정

> \## 기능설명\
> \* 메뉴의 상세정보를 수정합니다.\
> \---\
> \## 상세설명\
> \* 필수 값 목록\
> &#x20;  \* 권한대상유형코드\
> &#x20;  \* 권한대상명\
> &#x20;  \* 정렬순서\
> &#x20;  \* 사용여부\
> &#x20;  \* 시스템수정자아이디\
> &#x20;  \* 권한대상순번\
> &#x20;  \* 고객정보포함여부\
> &#x20;  \* 팝업여부\
> &#x20;  \* 최하위메뉴여부<br>

```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":{"AuthTargetBase":{"type":"object","description":"권한대상기본","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"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":"호출 Method"},"useYn":{"type":"string","description":"사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"type":"string","description":"사용자 도움말 내용"},"totalCount":{"type":"integer","format":"int32","description":"총 갯수"}}},"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/menuMgmt/{rtTgtSeq}":{"put":{"tags":["메뉴 정보 관리"],"summary":"메뉴 상세정보 수정","description":"## 기능설명\n* 메뉴의 상세정보를 수정합니다.\n---\n## 상세설명\n* 필수 값 목록\n   * 권한대상유형코드\n   * 권한대상명\n   * 정렬순서\n   * 사용여부\n   * 시스템수정자아이디\n   * 권한대상순번\n   * 고객정보포함여부\n   * 팝업여부\n   * 최하위메뉴여부\n","operationId":"modifyMenu","parameters":[{"name":"rtTgtSeq","in":"path","description":"권한대상순번","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthTargetBase"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴 목록 조회

> \## 기능설명\
> \* 메뉴 목록을 조회 하는 API입니다.\
> \---\
> \## 상세설명\
> \* 저장되어 있는 메뉴 목록을 조회 합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_241017 : 메뉴 트리 목록 조회 v2<br>

```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":{"RealGridListResponseAuthTargetBase":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/AuthTargetBase"}}}},"AuthTargetBase":{"type":"object","description":"권한대상기본","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"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":"호출 Method"},"useYn":{"type":"string","description":"사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"type":"string","description":"사용자 도움말 내용"},"totalCount":{"type":"integer","format":"int32","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/menuMgmt":{"get":{"tags":["메뉴 정보 관리"],"summary":"메뉴 목록 조회","description":"## 기능설명\n* 메뉴 목록을 조회 하는 API입니다.\n---\n## 상세설명\n* 저장되어 있는 메뉴 목록을 조회 합니다.\n---\n## 수정번호\n* Release v2.00_241017 : 메뉴 트리 목록 조회 v2\n","operationId":"getMenuList","parameters":[{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"sysGbCdList","in":"query","description":"시스템 구분 코드 목록","schema":{"type":"array"}},{"name":"rtTgtTypCd","in":"query","description":"권한유형코드","schema":{"type":"string"}},{"name":"rtTgtTypCdList","in":"query","description":"권한유형코드 목록","schema":{"type":"array"}},{"name":"rtGrpNo","in":"query","description":"권한그룹번호","schema":{"type":"string"}},{"name":"rtSubGbCd","in":"query","description":"권한주체 구분코드","schema":{"type":"string"}},{"name":"rtTgtSeq","in":"query","description":"권한대상순번","schema":{"type":"string"}},{"name":"uprRtTgtSeq","in":"query","description":"상위권한대상순번","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"사용여부","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","schema":{"type":"number"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","schema":{"type":"number"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseAuthTargetBase"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴 상세정보 등록

> \## 기능설명\
> \* 메뉴의 상세정보를 등록합니다.\
> \---\
> \## 상세설명\
> \* 필수 값 목록\
> &#x20;  \* 권한대상유형코드\
> &#x20;  \* 권한대상명\
> &#x20;  \* 정렬순서\
> &#x20;  \* 사용여부\
> &#x20;  \* 시스템수정자아이디\
> &#x20;  \* 시스템구분코드\
> &#x20;  \* 상위권한대상순번\
> &#x20;  \* 시스템등록자ID<br>

```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":{"AuthTargetBase":{"type":"object","description":"권한대상기본","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"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":"호출 Method"},"useYn":{"type":"string","description":"사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"type":"string","description":"사용자 도움말 내용"},"totalCount":{"type":"integer","format":"int32","description":"총 갯수"}}},"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/menuMgmt":{"post":{"tags":["메뉴 정보 관리"],"summary":"메뉴 상세정보 등록","description":"## 기능설명\n* 메뉴의 상세정보를 등록합니다.\n---\n## 상세설명\n* 필수 값 목록\n   * 권한대상유형코드\n   * 권한대상명\n   * 정렬순서\n   * 사용여부\n   * 시스템수정자아이디\n   * 시스템구분코드\n   * 상위권한대상순번\n   * 시스템등록자ID\n","operationId":"registerMenu","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthTargetBase"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴 상세정보 검증

> \## 기능설명\
> \* 메뉴의 상세정보를 검증합니다.\
> \---\
> \## 상세설명\
> \* 필수 값 목록\
> &#x20;  \* 권한대상유형코드\
> &#x20;  \* 권한대상명\
> &#x20;  \* 정렬순서\
> &#x20;  \* 사용여부\
> &#x20;  \* 시스템수정자아이디\
> &#x20;  \* 권한대상순번\
> &#x20;  \* 고객정보포함여부\
> &#x20;  \* 팝업여부\
> &#x20;  \* 최하위메뉴여부<br>

```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":{"AuthTargetBase":{"type":"object","description":"권한대상기본","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"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":"호출 Method"},"useYn":{"type":"string","description":"사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"type":"string","description":"사용자 도움말 내용"},"totalCount":{"type":"integer","format":"int32","description":"총 갯수"}}},"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/menuMgmt/validation":{"post":{"tags":["메뉴 정보 관리"],"summary":"메뉴 상세정보 검증","description":"## 기능설명\n* 메뉴의 상세정보를 검증합니다.\n---\n## 상세설명\n* 필수 값 목록\n   * 권한대상유형코드\n   * 권한대상명\n   * 정렬순서\n   * 사용여부\n   * 시스템수정자아이디\n   * 권한대상순번\n   * 고객정보포함여부\n   * 팝업여부\n   * 최하위메뉴여부\n","operationId":"validationMenu","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthTargetBase"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 개별메뉴 권한 설정

> \## 기능설명\
> \* 개별권한의 사용여부를 수정합니다.\
> \---\
> \## 상세설명\
> \* 개별권한의 사용여부를 수정합니다.\
> \* 개별권한 사용, 사용안함, 그룹권한 적용으로 수정합니다.<br>

```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":{"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":{"/v2/system/menuMgmt/saveIndividualMenuRight":{"post":{"tags":["메뉴 정보 관리"],"summary":"개별메뉴 권한 설정","description":"## 기능설명\n* 개별권한의 사용여부를 수정합니다.\n---\n## 상세설명\n* 개별권한의 사용여부를 수정합니다.\n* 개별권한 사용, 사용안함, 그룹권한 적용으로 수정합니다.\n","operationId":"saveIndividualMenuRight","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StRtInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 하위 메뉴 저장

> \## 기능설명\
> \* 메뉴의 하위 메뉴 목록을 등록, 수정, 삭제합니다.\
> \---\
> \## 상세설명\
> \* 필수 값 목록\
> &#x20;  \* 저장\
> &#x20;     \* 권한대상유형코드\
> &#x20;     \* 권한대상명\
> &#x20;     \* 정렬순서\
> &#x20;     \* 사용여부\
> &#x20;     \* 시스템수정자아이디\
> &#x20;     \* 시스템구분코드\
> &#x20;     \* 상위권한대상순번\
> &#x20;     \* 시스템등록자아이디\
> &#x20;  \* 수정\
> &#x20;     \* 권한대상유형코드\
> &#x20;     \* 권한대상명\
> &#x20;     \* 정렬순서\
> &#x20;     \* 사용여부\
> &#x20;     \* 시스템수정자아이디\
> &#x20;  \* 삭제\
> &#x20;     \* 권한대상유형코드\
> &#x20;     \* 권한대상명\
> &#x20;     \* 정렬순서\
> &#x20;     \* 사용여부\
> &#x20;     \* 시스템수정자아이디<br>

```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":{"RealGridCUDRequestStRtTgtBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StRtTgtBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StRtTgtBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StRtTgtBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StRtTgtBase"}}}},"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":"사용자도움말내용"}}},"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/menuMgmt/saveSubMenu":{"post":{"tags":["메뉴 정보 관리"],"summary":"하위 메뉴 저장","description":"## 기능설명\n* 메뉴의 하위 메뉴 목록을 등록, 수정, 삭제합니다.\n---\n## 상세설명\n* 필수 값 목록\n   * 저장\n      * 권한대상유형코드\n      * 권한대상명\n      * 정렬순서\n      * 사용여부\n      * 시스템수정자아이디\n      * 시스템구분코드\n      * 상위권한대상순번\n      * 시스템등록자아이디\n   * 수정\n      * 권한대상유형코드\n      * 권한대상명\n      * 정렬순서\n      * 사용여부\n      * 시스템수정자아이디\n   * 삭제\n      * 권한대상유형코드\n      * 권한대상명\n      * 정렬순서\n      * 사용여부\n      * 시스템수정자아이디\n","operationId":"saveSubMenu","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStRtTgtBase"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 개별권한 사용여부 수정

> \## 기능설명\
> \* 개별권한의 사용여부를 수정합니다.\
> \---\
> \## 상세설명\
> \* 개별권한의 사용여부를 수정합니다.\
> \* checkedNodes의 목록을 사용여부 Y로 수정합니다.\
> \* nonCheckedNodes의 목록을 사용여부 N으로 수정합니다.<br>

```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/menuMgmt/saveMenuRightIndiv":{"post":{"tags":["메뉴 정보 관리"],"summary":"개별권한 사용여부 수정","description":"## 기능설명\n* 개별권한의 사용여부를 수정합니다.\n---\n## 상세설명\n* 개별권한의 사용여부를 수정합니다.\n* checkedNodes의 목록을 사용여부 Y로 수정합니다.\n* nonCheckedNodes의 목록을 사용여부 N으로 수정합니다.\n","operationId":"saveMenuRightIndiv","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴 상세정보 등록

> \## 기능설명\
> \* 메뉴의 상세정보를 등록합니다.\
> \---\
> \## 상세설명\
> \* 필수 값 목록\
> &#x20;  \* 권한대상유형코드\
> &#x20;  \* 권한대상명\
> &#x20;  \* 정렬순서\
> &#x20;  \* 사용여부\
> &#x20;  \* 시스템수정자아이디\
> &#x20;  \* 시스템구분코드\
> &#x20;  \* 상위권한대상순번\
> &#x20;  \* 시스템등록자ID<br>

```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":{"RtTargetBaseCudRequest":{"type":"object","properties":{"rtTgtSeq":{"type":"string"},"sysGbCd":{"type":"string","minLength":1},"rtTgtTypCd":{"type":"string","minLength":1},"rtTgtNm":{"type":"string","minLength":1},"sortSeq":{"type":"integer","format":"int32"},"callUrl":{"type":"string","minLength":1},"useYn":{"type":"string"},"custInfoInclYn":{"type":"string"},"rmkCont":{"type":"string"},"popupYn":{"type":"string"},"btnId":{"type":"string"},"uprRtTgtSeq":{"type":"string","minLength":1},"leafMenuYn":{"type":"string","minLength":1},"userHelpCont":{"type":"string"}},"required":["callUrl","leafMenuYn","rtTgtNm","rtTgtTypCd","sortSeq","sysGbCd","uprRtTgtSeq"]},"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/menuMgmt/registMenuInfo":{"post":{"tags":["메뉴 정보 관리"],"summary":"메뉴 상세정보 등록","description":"## 기능설명\n* 메뉴의 상세정보를 등록합니다.\n---\n## 상세설명\n* 필수 값 목록\n   * 권한대상유형코드\n   * 권한대상명\n   * 정렬순서\n   * 사용여부\n   * 시스템수정자아이디\n   * 시스템구분코드\n   * 상위권한대상순번\n   * 시스템등록자ID\n","operationId":"registMenuInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RtTargetBaseCudRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴권한 사용여부 수정

> \## 기능설명\
> \* 메뉴권한의 사용여부를 수정합니다.\
> \---\
> \## 상세설명\
> \* 메뉴권한의 사용여부를 수정합니다.\
> \* checkedNodes의 목록을 사용여부 Y로 수정합니다.\
> \* nonCheckedNodes의 목록을 사용여부 N으로 수정합니다.<br>

```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/menuMgmt/modifyMenuRight":{"post":{"tags":["메뉴 정보 관리"],"summary":"메뉴권한 사용여부 수정","description":"## 기능설명\n* 메뉴권한의 사용여부를 수정합니다.\n---\n## 상세설명\n* 메뉴권한의 사용여부를 수정합니다.\n* checkedNodes의 목록을 사용여부 Y로 수정합니다.\n* nonCheckedNodes의 목록을 사용여부 N으로 수정합니다.\n","operationId":"modifyMenuRight","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴 상세정보 수정

> \## 기능설명\
> \* 메뉴의 상세정보를 수정합니다.\
> \---\
> \## 상세설명\
> \* 필수 값 목록\
> &#x20;  \* 권한대상유형코드\
> &#x20;  \* 권한대상명\
> &#x20;  \* 정렬순서\
> &#x20;  \* 사용여부\
> &#x20;  \* 시스템수정자아이디\
> &#x20;  \* 권한대상순번\
> &#x20;  \* 고객정보포함여부\
> &#x20;  \* 팝업여부\
> &#x20;  \* 최하위메뉴여부<br>

```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":{"RtTargetBaseCudRequest":{"type":"object","properties":{"rtTgtSeq":{"type":"string"},"sysGbCd":{"type":"string","minLength":1},"rtTgtTypCd":{"type":"string","minLength":1},"rtTgtNm":{"type":"string","minLength":1},"sortSeq":{"type":"integer","format":"int32"},"callUrl":{"type":"string","minLength":1},"useYn":{"type":"string"},"custInfoInclYn":{"type":"string"},"rmkCont":{"type":"string"},"popupYn":{"type":"string"},"btnId":{"type":"string"},"uprRtTgtSeq":{"type":"string","minLength":1},"leafMenuYn":{"type":"string","minLength":1},"userHelpCont":{"type":"string"}},"required":["callUrl","leafMenuYn","rtTgtNm","rtTgtTypCd","sortSeq","sysGbCd","uprRtTgtSeq"]},"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/menuMgmt/modifyMenuInfo":{"post":{"tags":["메뉴 정보 관리"],"summary":"메뉴 상세정보 수정","description":"## 기능설명\n* 메뉴의 상세정보를 수정합니다.\n---\n## 상세설명\n* 필수 값 목록\n   * 권한대상유형코드\n   * 권한대상명\n   * 정렬순서\n   * 사용여부\n   * 시스템수정자아이디\n   * 권한대상순번\n   * 고객정보포함여부\n   * 팝업여부\n   * 최하위메뉴여부\n","operationId":"modifyMenuInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RtTargetBaseCudRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 매핑된 상위 메뉴 목록 조회 조회

> \## 기능설명\
> \* 매핑된 상위 메뉴 목록 조회들을 조회됩니다.\
> \---\
> \## 상세설명\
> \* 매핑된 상위 메뉴 목록 조회들을 조회됩니다.\
> \* 필수 값 목록\
> &#x20;  \* 상위권한대상순번 목록<br>

```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":{"AuthTargetSearch":{"type":"object","description":"권한대상기본 검색 모델","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"uprRtTgtSeqList":{"type":"array","description":"상위권한대상순번 목록","items":{"type":"string"}},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"sysGbCdList":{"type":"array","description":"시스템구분코드(UR005) 목록","items":{"type":"string"}},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"rtTgtTypCdList":{"type":"array","description":"권한대상유형코드(UR010) 목록","items":{"type":"string"}},"rtGrpNo":{"type":"string","description":"권한그룹번호"},"rtSubGbCd":{"type":"string","description":"권한주체 구분코드(UR006)"},"useYn":{"type":"string","description":"사용여부"}}},"ResponseListAuthTargetBase":{"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/AuthTargetBase"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"AuthTargetBase":{"type":"object","description":"권한대상기본","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"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":"호출 Method"},"useYn":{"type":"string","description":"사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"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/menuMgmt/upper":{"get":{"tags":["메뉴 정보 관리"],"summary":"매핑된 상위 메뉴 목록 조회 조회","description":"## 기능설명\n* 매핑된 상위 메뉴 목록 조회들을 조회됩니다.\n---\n## 상세설명\n* 매핑된 상위 메뉴 목록 조회들을 조회됩니다.\n* 필수 값 목록\n   * 상위권한대상순번 목록\n","operationId":"getMappedUpperMenuList","parameters":[{"name":"authTargetSearch","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AuthTargetSearch"}},{"name":"uprRtTgtSeqList","in":"query","description":"상위권한대상순번 목록","required":true,"schema":{"type":"array"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListAuthTargetBase"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴 트리 목록 조회

> \## 기능설명\
> \* 저장되어 있는 메뉴가 트리 구조로 조회됩니다.\
> \---\
> \## 상세설명\
> \* 저장되어 있는 메뉴가 트리 구조로 조회됩니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_241017 : 메뉴 트리 목록 조회 v2<br>

```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/menuMgmt/getMenuMgmtTreeList":{"get":{"tags":["메뉴 정보 관리"],"summary":"메뉴 트리 목록 조회","description":"## 기능설명\n* 저장되어 있는 메뉴가 트리 구조로 조회됩니다.\n---\n## 상세설명\n* 저장되어 있는 메뉴가 트리 구조로 조회됩니다.\n---\n## 수정번호\n* Release v2.00_241017 : 메뉴 트리 목록 조회 v2\n","operationId":"getMenuMgmtTreeList","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"rtGrpNo","in":"query","description":"권한그룹번호","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"사용여부","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListRtTargetBaseResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 하위 메뉴 목록 조회

> \## 기능설명\
> \* 화면에서 클릭한 메뉴의 하위 메뉴 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 클릭한 메뉴의 하위 메뉴 목록을 조회합니다.<br>

```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"}}},"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":"사용자 도움말 내용"}}},"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/menuMgmt/getSubMenuList":{"get":{"tags":["메뉴 정보 관리"],"summary":"하위 메뉴 목록 조회","description":"## 기능설명\n* 화면에서 클릭한 메뉴의 하위 메뉴 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 클릭한 메뉴의 하위 메뉴 목록을 조회합니다.\n","operationId":"getSubMenuList","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"rtTgtSeq","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":{"type":"array","items":{"$ref":"#/components/schemas/RtTargetBaseResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 하위 메뉴 목록 건수 조회

> \## 기능설명\
> \* 화면에서 클릭한 메뉴의 하위 메뉴 목록 건수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 클릭한 메뉴의 하위 메뉴 목록 건수를 조회합니다.<br>

```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"}}},"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/menuMgmt/getSubMenuListCount":{"get":{"tags":["메뉴 정보 관리"],"summary":"하위 메뉴 목록 건수 조회","description":"## 기능설명\n* 화면에서 클릭한 메뉴의 하위 메뉴 목록 건수를 조회합니다.\n---\n## 상세설명\n* 화면에서 클릭한 메뉴의 하위 메뉴 목록 건수를 조회합니다.\n","operationId":"getSubMenuListCount","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"rtTgtSeq","in":"query","description":"권한대상순번","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 하위메뉴 존재여부 체크

> \## 기능설명\
> \* 권한대상순번에 대한 하위메뉴가 존재하는지 확인합니다.\
> \---\
> \## 상세설명\
> \* 권한대상순번에 대한 하위메뉴가 존재하는지 확인합니다.\
> \* 넘어온 권한대상순번을 상위권한대상순번으로 가진 메뉴의 건수를 반환합니다.\
> \* 필수 값 목록\
> &#x20;  \* 권한대상순번<br>

```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"}}},"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/menuMgmt/getSubMenuCheck":{"get":{"tags":["메뉴 정보 관리"],"summary":"하위메뉴 존재여부 체크","description":"## 기능설명\n* 권한대상순번에 대한 하위메뉴가 존재하는지 확인합니다.\n---\n## 상세설명\n* 권한대상순번에 대한 하위메뉴가 존재하는지 확인합니다.\n* 넘어온 권한대상순번을 상위권한대상순번으로 가진 메뉴의 건수를 반환합니다.\n* 필수 값 목록\n   * 권한대상순번\n","operationId":"getSubMenuCheck","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"rtTgtSeq","in":"query","description":"권한대상순번","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 유효한 권한대상 체크

> \## 기능설명\
> \* 권한대상순번에 대한 권한 정보가 존재하는지 확인합니다.\
> \---\
> \## 상세설명\
> \* 권한대상순번에 대해 사용여부가 Y인 권한 정보가 존재하는지 확인합니다.\
> \* 넘어온 권한대상순번을 가진 메뉴의 건수를 반환합니다.\
> \* 필수 값 목록\
> &#x20;  \* 권한대상순번<br>

```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"}}},"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/menuMgmt/getRtInfoCheck":{"get":{"tags":["메뉴 정보 관리"],"summary":"유효한 권한대상 체크","description":"## 기능설명\n* 권한대상순번에 대한 권한 정보가 존재하는지 확인합니다.\n---\n## 상세설명\n* 권한대상순번에 대해 사용여부가 Y인 권한 정보가 존재하는지 확인합니다.\n* 넘어온 권한대상순번을 가진 메뉴의 건수를 반환합니다.\n* 필수 값 목록\n   * 권한대상순번\n","operationId":"getRtInfoCheck","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"rtTgtSeq","in":"query","description":"권한대상순번","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메뉴 상세 정보 조회

> \## 기능설명\
> \* 화면에서 클릭한 메뉴의 샹세 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 클릭한 메뉴의 샹세 정보를 조회합니다.<br>

```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"}}},"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":"사용자 도움말 내용"}}},"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/menuMgmt/getMenuInfo":{"get":{"tags":["메뉴 정보 관리"],"summary":"메뉴 상세 정보 조회","description":"## 기능설명\n* 화면에서 클릭한 메뉴의 샹세 정보를 조회합니다.\n---\n## 상세설명\n* 화면에서 클릭한 메뉴의 샹세 정보를 조회합니다.\n","operationId":"getMenuInfo","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"rtTgtSeq","in":"query","description":"권한대상순번","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RtTargetBaseResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
