> 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-29.md).
# 메뉴별 사용현황 조회
## 사용자별 메뉴 사용현황 목록 조회
> \## 기능설명\
> \* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 사용자별 메뉴 사용현황 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 사용자별 메뉴 사용현황 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경
```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":{"RtTargetBaseLogRequest":{"type":"object","properties":{"userId":{"type":"string"},"sysGbCd":{"type":"string"},"userIdConditionParam":{"type":"string"},"userNmConditionParam":{"type":"string"},"useStrtDt":{"type":"string","format":"date"},"userEndDt":{"type":"string","format":"date"},"rtTgtNm":{"type":"string"}}},"RealGridListResponseRtTargetBaseLogResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/RtTargetBaseLogResponse"}}}},"RtTargetBaseLogResponse":{"type":"object","description":"메뉴별 사용현황 조회 응답 DTO","properties":{"sysGbNm":{"type":"string","description":"시스템구분명"},"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"권한대상명"},"menuRegDt":{"type":"string","description":"메뉴등록일자"},"userCnt":{"type":"integer","format":"int64","description":"사용자 수"},"menuUseCnt":{"type":"integer","format":"int64","description":"사용 수"},"lastUseDt":{"type":"string","description":"최종사용일자"},"userId":{"type":"string","description":"사용자ID"},"userNm":{"type":"string","description":"사용자명"},"userMenuUseCnt":{"type":"integer","format":"int64","description":"사용횟수"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"uprRtTgtNm":{"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/menuUsageStatusInquiry/getUserMenuUseStatusList":{"get":{"tags":["메뉴별 사용현황 조회"],"summary":"사용자별 메뉴 사용현황 목록 조회","description":"## 기능설명\n* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 사용자별 메뉴 사용현황 목록을 조회합니다.\n---\n## 상세설명\n* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 사용자별 메뉴 사용현황 목록을 조회합니다.\n---\n## 수정번호\n* Release v2.00_240530: 날짜조회 쿼리 변경\n","operationId":"getUserMenuUseStatusList","parameters":[{"name":"rtTargetBaseLogRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseLogRequest"}},{"name":"userId","in":"query","description":"사용자명","schema":{"type":"String"}},{"name":"sysGbCd","in":"query","description":"시스템구분코드","schema":{"type":"String"}},{"name":"useStrtDt","in":"query","description":"조회시작일자","schema":{"type":"LocalDate"}},{"name":"userEndDt","in":"query","description":"조회종료일자","schema":{"type":"LocalDate"}},{"name":"rtTgtNm","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/RealGridListResponseRtTargetBaseLogResponse"}}}},"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":{"RtTargetBaseLogRequest":{"type":"object","properties":{"userId":{"type":"string"},"sysGbCd":{"type":"string"},"userIdConditionParam":{"type":"string"},"userNmConditionParam":{"type":"string"},"useStrtDt":{"type":"string","format":"date"},"userEndDt":{"type":"string","format":"date"},"rtTgtNm":{"type":"string"}}},"RealGridListResponseRtTargetBaseLogResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/RtTargetBaseLogResponse"}}}},"RtTargetBaseLogResponse":{"type":"object","description":"메뉴별 사용현황 조회 응답 DTO","properties":{"sysGbNm":{"type":"string","description":"시스템구분명"},"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"권한대상명"},"menuRegDt":{"type":"string","description":"메뉴등록일자"},"userCnt":{"type":"integer","format":"int64","description":"사용자 수"},"menuUseCnt":{"type":"integer","format":"int64","description":"사용 수"},"lastUseDt":{"type":"string","description":"최종사용일자"},"userId":{"type":"string","description":"사용자ID"},"userNm":{"type":"string","description":"사용자명"},"userMenuUseCnt":{"type":"integer","format":"int64","description":"사용횟수"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"uprRtTgtNm":{"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/menuUsageStatusInquiry/getMenuUseStatusList":{"get":{"tags":["메뉴별 사용현황 조회"],"summary":"메뉴별 사용현황 목록 조회","description":"## 기능설명\n* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 메뉴별 사용현황 목록을 조회합니다.\n---\n## 상세설명\n* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 메뉴별 사용현황 목록을 조회합니다.\n* 하위메뉴일 경우 상위메뉴를 볼 수 있습니다.\n","operationId":"getMenuUseStatusList","parameters":[{"name":"rtTargetBaseLogRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseLogRequest"}},{"name":"userId","in":"query","description":"사용자명","schema":{"type":"String"}},{"name":"sysGbCd","in":"query","description":"시스템구분코드","schema":{"type":"String"}},{"name":"useStrtDt","in":"query","description":"조회시작일자","schema":{"type":"String"}},{"name":"userEndDt","in":"query","description":"조회종료일자","schema":{"type":"String"}},{"name":"rtTgtNm","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/RealGridListResponseRtTargetBaseLogResponse"}}}},"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":{"RtTargetBaseLogRequest":{"type":"object","properties":{"userId":{"type":"string"},"sysGbCd":{"type":"string"},"userIdConditionParam":{"type":"string"},"userNmConditionParam":{"type":"string"},"useStrtDt":{"type":"string","format":"date"},"userEndDt":{"type":"string","format":"date"},"rtTgtNm":{"type":"string"}}},"ResponseInteger":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"integer","format":"int32","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/system/menuUsageStatusInquiry/getMenuUseStatusListCount":{"get":{"tags":["메뉴별 사용현황 조회"],"summary":"메뉴별 사용현황 건수 조회","description":"## 기능설명\n* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 메뉴별 사용현황 건수를 조회합니다.\n---\n## 상세설명\n* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 메뉴별 사용현황 건수를 조회합니다.\n","operationId":"getMenuUseStatusListCount","parameters":[{"name":"rtTargetBaseLogRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseLogRequest"}},{"name":"userId","in":"query","description":"사용자명","schema":{"type":"String"}},{"name":"sysGbCd","in":"query","description":"시스템구분코드","schema":{"type":"String"}},{"name":"useStrtDt","in":"query","description":"조회시작일자","schema":{"type":"String"}},{"name":"userEndDt","in":"query","description":"조회종료일자","schema":{"type":"String"}},{"name":"rtTgtNm","in":"query","description":"메뉴명","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseInteger"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```