> 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/store-front-api/member-api/undefined-15.md).
# 마이페이지
## 임직원 할인한도 조회
> \## 기능설명\
> \* 임직원의 할인한도를 조회합니다.\
> \---\
> \## 상세설명\
> \* 임직원 할인한도 상태(잔여금액 및 한도 금액)를 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.03\_231106: 임직원 할인한도 최초개발
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/staff/getDsctLmtStat":{"get":{"tags":["마이페이지"],"summary":"임직원 할인한도 조회","description":"## 기능설명\n* 임직원의 할인한도를 조회합니다.\n---\n## 상세설명\n* 임직원 할인한도 상태(잔여금액 및 한도 금액)를 조회합니다.\n---\n## 수정번호\n* Release v1.03_231106: 임직원 할인한도 최초개발\n","operationId":"getDsctLmtStat","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DsctLmtStatResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"DsctLmtStatResponse":{"type":"object","description":"임직원 할인한도 조회 Response","properties":{"mbrNo":{"type":"string","description":"회원번호"},"rmndAmt":{"type":"integer","format":"int64","description":"임직원할인 잔여금액"},"limAmt":{"type":"integer","format":"int64","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"}}}}}}
```
## 회원 마이페이지메인 정보 조회
> \## 기능설명\
> \* 회원의 마이페이지 메인 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 로그인은 필수입니다.\
> \* 회원의 기본 정보 (회원번호, 임직원여부, 회원이름)를 조회합니다.\
> \* 보유 혜택: 회원이 보유하고 있는 마일리지와 쿠폰 개수를 조회합니다.\
> \* 활동 현황: 회원의 이벤트 참여현황, 상품QA, 1:1문의에 대한 건수를 조회합니다.\
> \* 전체 메뉴: 메뉴 정보를 조회합니다.\
> \* 회원의 해당 메뉴에 대한 즐겨찾기여부 정보도 함께 제공됩니다.\
> \* 알림함 수: 회원이 조회하지 않은 알림의 개수를 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v2.00\_240401\`\`\`: 알림함 수 조회 추가
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/myPage/myPageMain":{"get":{"tags":["마이페이지"],"summary":"회원 마이페이지메인 정보 조회","description":"## 기능설명\n* 회원의 마이페이지 메인 정보를 조회합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 회원의 기본 정보 (회원번호, 임직원여부, 회원이름)를 조회합니다.\n* 보유 혜택: 회원이 보유하고 있는 마일리지와 쿠폰 개수를 조회합니다.\n* 활동 현황: 회원의 이벤트 참여현황, 상품QA, 1:1문의에 대한 건수를 조회합니다.\n* 전체 메뉴: 메뉴 정보를 조회합니다.\n * 회원의 해당 메뉴에 대한 즐겨찾기여부 정보도 함께 제공됩니다.\n* 알림함 수: 회원이 조회하지 않은 알림의 개수를 조회합니다.\n---\n## 수정번호\n* ```Release v2.00_240401```: 알림함 수 조회 추가\n","operationId":"myPageMain","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MypageMainResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MypageMainResponse":{"type":"object","properties":{"stafYn":{"type":"string","description":"임직원 여부"},"mbrNm":{"type":"string","description":"회원 이름"},"mbrNo":{"type":"string","description":"회원 번호"},"benefitInfo":{"$ref":"#/components/schemas/AssetsHeldResponse","description":"보유혜택"},"actInfo":{"$ref":"#/components/schemas/ParticipationStatusResponse","description":"활동현황"},"menuList":{"type":"array","description":"전체메뉴","items":{"$ref":"#/components/schemas/MenuInfoListResponse"}},"notiBoxCount":{"type":"integer","format":"int64","description":"알림함 수"}}},"AssetsHeldResponse":{"type":"object","properties":{"crrtMlg":{"type":"integer","format":"int64","description":"보유 마일리지"},"cpnAvalCnt":{"type":"integer","format":"int32","description":"보유 쿠폰 개수"}}},"ParticipationStatusResponse":{"type":"object","properties":{"evtCnt":{"type":"integer","format":"int32","description":"이벤트참여현황건수"},"goodsQaCnt":{"type":"integer","format":"int32","description":"상품QA건수"},"inquiryCnt":{"type":"integer","format":"int32","description":"1:1문의건수"}}},"MenuInfoListResponse":{"type":"object","properties":{"uprMenuId":{"type":"string","description":"상위메뉴ID"},"uprMenuNm":{"type":"string","description":"상위메뉴이름"},"menuDtlList":{"type":"array","description":"하위메뉴 리스트","items":{"$ref":"#/components/schemas/BookMarkResponse"}}}},"BookMarkResponse":{"type":"object","properties":{"menuDtlId":{"type":"string","description":"메뉴ID"},"menuDtlNm":{"type":"string","description":"메뉴이름"},"callUrl":{"type":"string","description":"호출Url"},"iconUrl":{"type":"string","description":"아이콘url"},"myBkmkMenuYn":{"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"}}}}}}
````
## 회원 마이페이지 메뉴 정보 조회
> \## 기능설명\
> \* 메뉴 정보를 조회합니다.\
> \---\
> \* 마이페이지 메뉴 정보를 조회합니다.\
> \* 메뉴 ID와 메뉴명, 호출 url을 조회합니다.\
> \* 로그인은 필수가 아니며, 북마크 여부는 조회하지 않습니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v2.00\_240401\`\`\`: 알림함 수 조회 추가
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/myPage/menuList":{"get":{"tags":["마이페이지"],"summary":"회원 마이페이지 메뉴 정보 조회","description":"## 기능설명\n* 메뉴 정보를 조회합니다.\n---\n* 마이페이지 메뉴 정보를 조회합니다.\n* 메뉴 ID와 메뉴명, 호출 url을 조회합니다.\n* 로그인은 필수가 아니며, 북마크 여부는 조회하지 않습니다.\n---\n## 수정번호\n* ```Release v2.00_240401```: 알림함 수 조회 추가\n","operationId":"menuList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MenuInfoListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MenuInfoListResponse":{"type":"object","properties":{"uprMenuId":{"type":"string","description":"상위메뉴ID"},"uprMenuNm":{"type":"string","description":"상위메뉴이름"},"menuDtlList":{"type":"array","description":"하위메뉴 리스트","items":{"$ref":"#/components/schemas/BookMarkResponse"}}}},"BookMarkResponse":{"type":"object","properties":{"menuDtlId":{"type":"string","description":"메뉴ID"},"menuDtlNm":{"type":"string","description":"메뉴이름"},"callUrl":{"type":"string","description":"호출Url"},"iconUrl":{"type":"string","description":"아이콘url"},"myBkmkMenuYn":{"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"}}}}}}
````
## 회원 상위 등급 조회
> \## 기능설명\
> \* 회원의 등급 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 로그인은 필수입니다.\
> \* 회원의 현재 등급과 상위 등급을 조회합니다.\
> \* 상위등급 산정 기준은 최근 6개월 주문금액입니다.\
> \* 현재 2023년 7월일 때, 2023년 7월 -> 2023-02-01 \~ 2023-07-31로 산정\
> \* 주문금액 에러 발생시 0원으로 처리합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/myPage/highGradeInfo":{"get":{"tags":["마이페이지"],"summary":"회원 상위 등급 조회","description":"## 기능설명\n* 회원의 등급 정보를 조회합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 회원의 현재 등급과 상위 등급을 조회합니다.\n* 상위등급 산정 기준은 최근 6개월 주문금액입니다.\n * 현재 2023년 7월일 때, 2023년 7월 -> 2023-02-01 ~ 2023-07-31로 산정\n* 주문금액 에러 발생시 0원으로 처리합니다.\n","operationId":"getHighGradeInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/HighGradeInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"HighGradeInfoResponse":{"type":"object","description":"상위 회원등급 정보","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)","enum":["GREEN","FAMILY","GOLD","VIP","VVIP"]},"mbrGradeNm":{"type":"string","description":"회원등급명"},"nowSalesAmt":{"type":"integer","format":"int64","description":"현재 회원 매출 금액"},"histStrDt":{"type":"string","description":"현재 등급기준 시작일자"},"histEndDt":{"type":"string","description":"현재 등급기준 종료일자"},"highMbrGradeDate":{"type":"string","description":"상위 회원등급 년월"},"highMbrGradeCd":{"type":"string","description":"상위 회원등급코드(ME008)"},"highMbrGradeNm":{"type":"string","description":"상위 회원등급명"},"highGradeSalesAmt":{"type":"integer","format":"int64","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"}}}}}}
```