# 메뉴별 사용현황 조회
## 사용자별 메뉴 사용현황 목록 조회
> \## 기능설명\
> \* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 사용자별 메뉴 사용현황 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 시스템 구분, 사용자, 사용기간, 메뉴명에 맞는 사용자별 메뉴 사용현황 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* 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"}}}}}}}}}
```
---
# 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-29.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.