# 회원공통 ## APP PUSH 동의여부 조회 > \## 기능설명\ > \* 회원 APP PUSH 동의 여부를 조회합니다.\ > \---\ > \## 상세설명\ > \* 고객의 모바일 전용 APP PUSH 동의 여부를 조회합니다.\ > \---\ > \## 특이사항\ > \* 모바일 App 전용 API로, 웹에서는 사용하지 않습니다.
```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/member/memberPushInfo":{"post":{"tags":["회원공통"],"summary":"APP PUSH 동의여부 조회","description":"## 기능설명\n* 회원 APP PUSH 동의 여부를 조회합니다.\n---\n## 상세설명\n* 고객의 모바일 전용 APP PUSH 동의 여부를 조회합니다.\n---\n## 특이사항\n* 모바일 App 전용 API로, 웹에서는 사용하지 않습니다.\n","operationId":"getMemberPushAgrYn","parameters":[{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"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"}}}}}} ``` ## APP PUSH 동의여부 수정 > \## 기능설명\ > \* 회원 APP PUSH 동의 여부 변경합니다.\ > \---\ > \## 상세설명\ > \* 고객의 모바일 전용 APP PUSH 동의 여부를 변경합니다.\ > \---\ > \## 특이사항\ > \* 모바일 App 전용 API로, 웹에서는 사용하지 않습니다.\ > \* appPushAgrYn 필드의 경우 Y, N의 값만 허용됩니다.\ > \---\ > \## 수정번호\ > \* Release v1.05\_231204: 첫 APP PUSH 수신동의 시 쿠폰발급 추가\ > \* appPushAgrYn 필드 값이 Y일 경우 회원의 앱 푸시 수신동의 쿠폰 지급여부가 'N'일 때 쿠폰을 지급합니다.
```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/member/memberPushInfo":{"put":{"tags":["회원공통"],"summary":"APP PUSH 동의여부 수정","description":"## 기능설명\n* 회원 APP PUSH 동의 여부 변경합니다.\n---\n## 상세설명\n* 고객의 모바일 전용 APP PUSH 동의 여부를 변경합니다.\n---\n## 특이사항\n* 모바일 App 전용 API로, 웹에서는 사용하지 않습니다.\n* appPushAgrYn 필드의 경우 Y, N의 값만 허용됩니다.\n---\n## 수정번호\n* Release v1.05_231204: 첫 APP PUSH 수신동의 시 쿠폰발급 추가\n * appPushAgrYn 필드 값이 Y일 경우 회원의 앱 푸시 수신동의 쿠폰 지급여부가 'N'일 때 쿠폰을 지급합니다.\n","operationId":"updateMemberPushInfo","parameters":[{"name":"appPushInfoRequest","in":"query","description":"앱 푸시 동의 여부","required":true,"schema":{"type":"string","description":"AppPushInfoRequest"}},{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppPushInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"AppPushInfoRequest":{"type":"object","description":"APP PUSH 정보 수정 Request","properties":{"appPushAgrYn":{"type":"string","description":"APP PUSH 동의 여부"}}},"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"}}}}}} ``` ## APP 기기정보 정보 저장 > \## 기능설명\ > \* APP으로 부터 전송된 기기정보 정보를 받아 저장한다.\ > \---\ > \## 상세설명\ > \* APP을 사용하는 고객의 모바일 정보를 저장합니다.\ > \* 최초 APP 로그인 시, 앱 최초 로그인 쿠폰을 발급합니다.\ > \---\ > \## 특이사항\ > \* 모바일 App 전용 API로, 웹에서는 지원하지 않습니다.\ > \## 수정번호\ > \* Release v1.05\_231204: APP 첫 로그인 쿠폰 발급 로직 추가\ > \* Release v2.00\_240509: 푸쉬 기능 미포함으로 모바일 메세지 토큰 키(moblMsgTknKey) 필수 값 제외
```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/member/memberAppInfo":{"put":{"tags":["회원공통"],"summary":"APP 기기정보 정보 저장","description":"## 기능설명\n* APP으로 부터 전송된 기기정보 정보를 받아 저장한다.\n---\n## 상세설명\n* APP을 사용하는 고객의 모바일 정보를 저장합니다.\n* 최초 APP 로그인 시, 앱 최초 로그인 쿠폰을 발급합니다.\n---\n## 특이사항\n* 모바일 App 전용 API로, 웹에서는 지원하지 않습니다.\n## 수정번호\n* Release v1.05_231204: APP 첫 로그인 쿠폰 발급 로직 추가\n* Release v2.00_240509: 푸쉬 기능 미포함으로 모바일 메세지 토큰 키(moblMsgTknKey) 필수 값 제외\n","operationId":"saveMemberAppInfo","parameters":[{"name":"appInfoRequest","in":"query","description":"회원 모바일 기기 정보","required":true,"schema":{"type":"string","description":"EtMbrMoblMachInfo"}},{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"AppInfoRequest":{"type":"object","properties":{"moblMachTypCd":{"type":"string","description":"모바일기기유형코드(ME049) 10: 스마트폰,20: 태블릿 PC,30: 스마트워치"},"moblMachModlNm":{"type":"string","description":"모바일기기모델명"},"moblOsTypCd":{"type":"string","description":"모바일OS유형코드(ME050) 10: IOS, 20: Android"},"moblOsVerNo":{"type":"string","description":"모바일OS버전번호"},"moblMsgTknKey":{"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"}}}}}} ``` ## 회원 주문일자 수정 > \## 기능설명\ > \* 회원의 최초 및 최종 주문일자를 업데이트합니다.\ > \---\ > \## 상세설명\ > \* 고객이 상품 주문 시 최초 주문일자와 최종 주문일자를 회원 기본 정보 데이터에 기록합니다.\ > \* 최초 주문 정보는 1회만 기록되며, 최종 주문일자는 고객의 주문 데이터가 생성될 때마다 갱신됩니다.\ > \---\ > \## 특이사항\ > \* 외부 접속이 차단된 API로, 내부 서버에서만 접근이 가능합니다.
```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/member/mbrOrdDtInfo":{"put":{"tags":["회원공통"],"summary":"회원 주문일자 수정","description":"## 기능설명\n* 회원의 최초 및 최종 주문일자를 업데이트합니다.\n---\n## 상세설명\n* 고객이 상품 주문 시 최초 주문일자와 최종 주문일자를 회원 기본 정보 데이터에 기록합니다.\n* 최초 주문 정보는 1회만 기록되며, 최종 주문일자는 고객의 주문 데이터가 생성될 때마다 갱신됩니다.\n---\n## 특이사항\n* 외부 접속이 차단된 API로, 내부 서버에서만 접근이 가능합니다.\n","operationId":"modifyMbrOrdDtlInfo","parameters":[{"name":"mbrOrdDtmInfoRequest","in":"query","description":"회원 주문일자 정보","required":true,"schema":{"type":"string","description":"MbrOrdDtmInfoRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MbrOrdDtmInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MbrOrdDtmInfoRequest":{"type":"object","description":"주문일자 정보 업데이트 Request","properties":{"mbrNo":{"type":"string","description":"회원번호"},"ordDtm":{"type":"string","format":"date-time","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"}}}}}} ``` ## 비밀번호 확인 > \## 기능설명\ > \* 회원의 현재 비밀번호를 확인합니다.\ > \---\ > \## 상세설명\ > \* 본인확인\ > \* 개인정보가 존재하는 페이지에 접속 하기 전, 현재 패스워드 검증을 통해 본인을 인증합니다.\ > \---\ > \## 특이사항\ > \* 패스워드의 경우 암호화된 값을 전달합니다.
```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/member/checkCurrentPassword":{"post":{"tags":["회원공통"],"summary":"비밀번호 확인","description":"## 기능설명\n* 회원의 현재 비밀번호를 확인합니다.\n---\n## 상세설명\n* 본인확인\n * 개인정보가 존재하는 페이지에 접속 하기 전, 현재 패스워드 검증을 통해 본인을 인증합니다.\n---\n## 특이사항\n* 패스워드의 경우 암호화된 값을 전달합니다.\n","operationId":"checkCurrentPassword","parameters":[{"name":"request","in":"query","description":"현재 비밀번호 정보","required":true,"schema":{"type":"string","description":"CurrentPasswordRequest"}},{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrentPasswordRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CurrentPasswordRequest":{"type":"object","description":"회원 현재 비밀번호 확인 Request","properties":{"lgnId":{"type":"string","description":"로그인ID"},"pwd":{"type":"string","description":"비밀번호"}},"required":["pwd"]},"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"}}}}}} ``` ## 사업자등록정보 진위확인 > \## 기능 설명\ > \* 국세청 사업자등록정보 진위확인 API 입니다.\ > \---\ > \## 상세 설명\ > \* 사업자등록번호, 대표자명, 개업일자 등을 입력받아 진위여부를 확인합니다.\ > \* 국세청 API를 통해 실시간으로 조회합니다.
```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/member/business/validate":{"post":{"tags":["회원공통"],"summary":"사업자등록정보 진위확인","description":" ## 기능 설명\n * 국세청 사업자등록정보 진위확인 API 입니다.\n ---\n ## 상세 설명\n * 사업자등록번호, 대표자명, 개업일자 등을 입력받아 진위여부를 확인합니다.\n * 국세청 API를 통해 실시간으로 조회합니다.\n","operationId":"getNtsBusinessValidate","parameters":[{"name":"request","in":"query","description":"사업자등록정보 조회 요청","required":true,"schema":{"$ref":"#/components/schemas/NtsValidateRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NtsValidateRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NtsValidateResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"NtsValidateRequest":{"type":"object","description":"국세청 사업자등록정보 진위확인 요청","properties":{"bmanRegNo":{"type":"string","description":"사업자등록번호","minLength":1,"pattern":"^\\d{10}$"},"bmanRegDt":{"type":"string","description":"개업일자(YYYYMMDD)","minLength":1,"pattern":"^\\d{8}$"},"rpstmnNm":{"type":"string","description":"대표자성명","minLength":1},"rpstmnNm2":{"type":"string","description":"대표자성명2"},"bmanNm":{"type":"string","description":"사업자명"},"corpNo":{"type":"string","description":"법인등록번호","pattern":"^\\d{13}$"},"bmanSector":{"type":"string","description":"주업태"},"bmanType":{"type":"string","description":"주종목"},"bmanAddr":{"type":"string","description":"사업장주소"}},"required":["bmanRegDt","bmanRegNo","rpstmnNm"]},"NtsValidateResponse":{"type":"object","description":"사업자등록정보 진위확인 응답","properties":{"requestCnt":{"type":"integer","format":"int32","description":"요청 건수"},"statusCode":{"type":"string","description":"상태 코드"},"validCnt":{"type":"integer","format":"int32","description":"검증 Valid 수"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"valid":{"type":"string","description":"진위확인 결과 (01: 일치, 02: 불일치)"},"validMsg":{"type":"string","description":"진위확인 메시지"},"registPsbYn":{"type":"boolean","description":"회원가입가능여부"},"bmanStatus":{"type":"string","description":"사업자 상태"},"bmanStatusCd":{"type":"string","description":"사업자 상태 코드"},"taxType":{"type":"string","description":"과세유형"},"taxTypeCd":{"type":"string","description":"과세유형 코드"},"bmanEndDt":{"type":"string","description":"폐업일자"},"utccYn":{"type":"string","description":"단위과세전환여부"},"taxTypeChangeDt":{"type":"string","description":"과세유형전환일자"},"invoiceApplyDt":{"type":"string","description":"인보이스적용일자"},"rbfTaxType":{"type":"string","description":"반기별예정신고대상여부"},"rbfTaxTypeCd":{"type":"string","description":"반기별예정신고대상여부 코드"},"bmanRegDt":{"type":"string","description":"개업일자(YYYYMMDD)"},"rpstmnNm":{"type":"string","description":"대표자성명"},"rpstmnNm2":{"type":"string","description":"대표자성명2"},"bmanNm":{"type":"string","description":"사업자명"},"corpNo":{"type":"string","description":"법인등록번호"},"bmanSector":{"type":"string","description":"주업태"},"bmanType":{"type":"string","description":"주종목"},"bmanAddr":{"type":"string","description":"사업장주소"},"wdraYn":{"type":"string","description":"탈퇴재가입여부"},"rejoinPossibleDay":{"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"}}}}}} ``` ## 사업자등록 상태조회 > \## 기능 설명\ > \* 국세청 사업자등록 상태를 조회하는 API 입니다.\ > \---\ > \## 상세 설명\ > \* 사업자등록번호를 입력받아 휴/폐업 상태를 조회합니다.\ > \* 계속사업자, 휴업자, 폐업자 등의 상태를 확인할 수 있습니다.
```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/member/business/status":{"post":{"tags":["회원공통"],"summary":"사업자등록 상태조회","description":" ## 기능 설명\n * 국세청 사업자등록 상태를 조회하는 API 입니다.\n ---\n ## 상세 설명\n * 사업자등록번호를 입력받아 휴/폐업 상태를 조회합니다.\n * 계속사업자, 휴업자, 폐업자 등의 상태를 확인할 수 있습니다.\n","operationId":"getNtsBusinessStatus","parameters":[{"name":"request","in":"query","description":"사업자등록 상태조회 요청","required":true,"schema":{"$ref":"#/components/schemas/NtsStatusRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NtsStatusRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NtsStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"NtsStatusRequest":{"type":"object","description":"국세청 사업자등록 상태조회 요청","properties":{"bmanRegNo":{"type":"string","description":"사업자등록번호","minLength":1,"pattern":"^\\d{10}$"}},"required":["bmanRegNo"]},"NtsStatusResponse":{"type":"object","description":"사업자등록정보 조회 응답","properties":{"requestCnt":{"type":"integer","format":"int32","description":"요청 건수"},"statusCode":{"type":"string","description":"상태 코드"},"matchCnt":{"type":"integer","format":"int32","description":"일치 건수"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"bmanStatus":{"type":"string","description":"사업자 상태"},"bmanStatusCd":{"type":"string","description":"사업자 상태 코드 (01: 계속사업자, 02: 휴업자, 03: 폐업자)"},"taxType":{"type":"string","description":"과세유형"},"taxTypeCd":{"type":"string","description":"과세유형 코드 (01: 간이과세자, 02: 일반과세자, 03: 면세사업자, 04: 법인사업자)"},"bmanEndDt":{"type":"string","description":"폐업일자"},"utccYn":{"type":"string","description":"단위과세전환여부 (Y/N)"},"taxTypeChangeDt":{"type":"string","description":"과세유형전환일자"},"invoiceApplyDt":{"type":"string","description":"인보이스적용일자"},"rbfTaxType":{"type":"string","description":"반기별예정신고대상여부"},"rbfTaxTypeCd":{"type":"string","description":"반기별예정신고대상여부 코드"},"validMsg":{"type":"string","description":"예외처리 메세지"},"isBmanRegNoDupl":{"type":"boolean","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"}}}}}} ``` ## 상품별 좋아요 여부 조회 > \## 기능설명\ > \* 상품번호에 대한 좋아요 여부를 조회합니다.\ > \---\ > \## 상세설명\ > \* 로그인은 필수입니다.\ > \* 상품 상세 상단 및 장바구니에 위시리스트여부를 표시하기 위해 활용됩니다.\ > \* goodsNo를 빈 리스트로 보내면 로그인한 회원에 대한 위시리스트 전체 목록을 조회합니다.\ > \* goodsNo 존재 시 해당 상품번호에 대한 위시리스트 여부를 Y, N으로 응답합니다.
```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/front/wishlistProducts":{"post":{"tags":["회원공통"],"summary":"상품별 좋아요 여부 조회","description":"## 기능설명\n* 상품번호에 대한 좋아요 여부를 조회합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 상품 상세 상단 및 장바구니에 위시리스트여부를 표시하기 위해 활용됩니다.\n* goodsNo를 빈 리스트로 보내면 로그인한 회원에 대한 위시리스트 전체 목록을 조회합니다.\n* goodsNo 존재 시 해당 상품번호에 대한 위시리스트 여부를 Y, N으로 응답합니다.\n","operationId":"wishlistProducts","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WishlistProductsRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WishlistProductsResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"WishlistProductsRequest":{"type":"object","description":"상품 좋아요 여부 Request","properties":{"mbrNo":{"type":"string","description":"회원번호"},"goodsNo":{"type":"array","description":"상품번호 목록","items":{"type":"string"}}},"required":["goodsNo","mbrNo"]},"WishlistProductsResponse":{"type":"object","description":"단일 상품 좋아요 여부 Response","properties":{"likeYn":{"type":"string","description":"좋아요 여부"},"goodsNo":{"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"}}}}}} ``` ## 회원 필수 정보 조회 > \## 기능설명\ > \* 로그인 이후 로그인한 회원의 정보를 조회합니다.\ > \---\ > \## 상세설명\ > \* 로그인 과정을 통해 인증 및 인가된 계정은 각 모듈 API에서 회원의 필수 정보를 활용 및 권한인증을 위하여 UserDetail 정보가 생성됩니다.\ > \* 로그인 과정 중 Redis 서버의 오류 등 예기치 못한 오류로 인하여 정상적으로 데이터가 등록 되지 않았을 때, 회원 필수 정보를 조회하여 TokenFilter에서 Redis 재등록을 시도합니다.\ > \---\ > \## 특이사항\ > \* 외부 접속이 차단된 API로, 내부 서버에서만 접근이 가능합니다.\ > \## 수정번호\ > \* Release v2.00\_240401: token Redis 이관작업에 따른 구조 변경
```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/front/userDetail":{"post":{"tags":["회원공통"],"summary":"회원 필수 정보 조회","description":"## 기능설명\n* 로그인 이후 로그인한 회원의 정보를 조회합니다.\n---\n## 상세설명\n* 로그인 과정을 통해 인증 및 인가된 계정은 각 모듈 API에서 회원의 필수 정보를 활용 및 권한인증을 위하여 UserDetail 정보가 생성됩니다.\n* 로그인 과정 중 Redis 서버의 오류 등 예기치 못한 오류로 인하여 정상적으로 데이터가 등록 되지 않았을 때, 회원 필수 정보를 조회하여 TokenFilter에서 Redis 재등록을 시도합니다.\n---\n## 특이사항\n* 외부 접속이 차단된 API로, 내부 서버에서만 접근이 가능합니다.\n## 수정번호\n* Release v2.00_240401: token Redis 이관작업에 따른 구조 변경\n","operationId":"getUserDetail","parameters":[{"name":"userDetail","in":"query","description":"회원 번호 및 지역 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDetail"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UserDetail"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"UserDetail":{"type":"object","properties":{"userName":{"type":"string"},"mbrNo":{"type":"string"},"mbrMgrCd":{"type":"string"},"mbrGbCd":{"type":"string"},"loginId":{"type":"string"},"mbrGradeCd":{"type":"string"},"stafYn":{"type":"string"},"sexGbCd":{"type":"string"},"adlCertiYn":{"type":"string"},"age":{"type":"string"},"langCd":{"type":"string"},"comGbCd":{"type":"string"},"token":{"type":"string"},"refreshToken":{"type":"string"},"uuid":{"type":"string"},"certiYn":{"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"}}}}}} ``` ## 회원 정보 조회(모바일전용) > \## 기능설명\ > \* 로그인한 계정의 회원정보를 조회합니다.\ > \---\ > \## 상세설명\ > \* 모바일에서 앱에서 활용할 로그인한 계정의 회원정보를 조회합니다.\ > \---\ > \## 특이사항\ > \* 모바일 App 전용 API로, 웹에서는 사용하지 않습니다.
```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/member/memberInfoApp":{"get":{"tags":["회원공통"],"summary":"회원 정보 조회(모바일전용)","description":"## 기능설명\n* 로그인한 계정의 회원정보를 조회합니다.\n---\n## 상세설명\n* 모바일에서 앱에서 활용할 로그인한 계정의 회원정보를 조회합니다.\n---\n## 특이사항\n* 모바일 App 전용 API로, 웹에서는 사용하지 않습니다.\n","operationId":"getMemberInfoApp","parameters":[{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MemberAppResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberAppResponse":{"type":"object","properties":{"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인 ID"},"sexGbCd":{"type":"string","description":"성별구분코드(ME017)","enum":["MALE","FEMALE"]}}},"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"}}}}}} ``` ## 회원 정보 목록 조회 > \## 기능설명\ > \* 개인정보가 마스킹 되지 않은 다건의 상세 회원 정보 목록을 조회합니다.\ > \---\ > \## 상세설명\ > \* 마스킹되어 있지 않은 회원의 정보로, 회원의 기본적인 정보를 목록으로 제공합니다.\ > \---\ > \## 특이사항\ > \* 외부 접속이 차단된 API로, 내부 서버에서만 접근이 가능합니다.\ > \---\ > \## 수정번호\ > \* Release v1.05\_231204: Response 컬럼 추가(주소 관련, 휴대폰 번호 관련, 로그인ID, 관리구분코드, 생년월일, 주문제한여부, 성인인증여부)
```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/member/getMemberInfoList":{"get":{"tags":["회원공통"],"summary":"회원 정보 목록 조회","description":"## 기능설명\n* 개인정보가 마스킹 되지 않은 다건의 상세 회원 정보 목록을 조회합니다.\n---\n## 상세설명\n* 마스킹되어 있지 않은 회원의 정보로, 회원의 기본적인 정보를 목록으로 제공합니다.\n---\n## 특이사항\n* 외부 접속이 차단된 API로, 내부 서버에서만 접근이 가능합니다.\n---\n## 수정번호\n* Release v1.05_231204: Response 컬럼 추가(주소 관련, 휴대폰 번호 관련, 로그인ID, 관리구분코드, 생년월일, 주문제한여부, 성인인증여부)\n","operationId":"getMemberInfoList","parameters":[{"name":"mbrDetailRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MemberDetailRequest"}},{"name":"memberDetailRequest","in":"query","description":"회원번호 목록","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MemberDetailResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberDetailRequest":{"type":"object","description":"회원정보 다건 조회 Request (프로모션에 제공)","properties":{"mbrNoList":{"type":"array","description":"회원번호 리스트","items":{"type":"string"}}}},"MemberDetailResponse":{"type":"object","description":"회원 조회 다건 Response","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrStatCd":{"type":"string","description":"회원상태코드(ME003)","enum":["NORMAL_MEMBER","STOP_MEMBER","WITHDRAWAL_MEMBER","WAIT_MEMBER","REJECT_MEMBER"]},"mbrGradeCd":{"type":"string","description":"회원등급","enum":["GREEN","FAMILY","GOLD","VIP","VVIP"]},"stafYn":{"type":"string","description":"임직원여부"},"comGbCd":{"type":"string","description":"임직원구분코드(ME038) P00: 플래티어"},"mbrGbCd":{"type":"string","description":"회원구분코드(ME001)","enum":["MEMBER","NO_MEMBER"]},"mbrMgrCd":{"type":"string","description":"회원관리코드(ME002)","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"주소"},"dtlAddr":{"type":"string","description":"상세주소"},"cellSctNo":{"type":"string","description":"핸드폰구분번호"},"cellTxnoNo":{"type":"string","description":"핸드폰국번번호"},"cellEndNo":{"type":"string","description":"핸드폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"mbrNm":{"type":"string","description":"회원명"},"emailAddr":{"type":"string","description":"이메일"},"loginId":{"type":"string","description":"로그인 ID"},"mgrGbCd":{"type":"string","description":"관리구분코드(ME019)"},"ordLmtYn":{"type":"string","description":"구매제한여부"},"brth":{"type":"string","description":"생년월일"},"adlCertiYn":{"type":"string","description":"성인인증여부"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"bmanNm":{"type":"string","description":"사업자명"},"bmanRegDt":{"type":"string","description":"사업자등록일자"},"joinSgtStatCd":{"type":"string","description":"가입승인상태코드(ME058)"},"rpstmnNm":{"type":"string","description":"대표자명"},"repTelSctNo":{"type":"string","description":"대표전화구분번호"},"repTelTxnoNo":{"type":"string","description":"대표전화국번번호"},"repTelEndNo":{"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"}}}}}} ``` ## 선물수신자 회원번호 조회 > \## 기능설명\ > \* 선물하기 서비스를 이용하기 위해 회원 번호를 조회합니다.\ > \---\ > \## 상세설명\ > \* 휴대폰번호를 입력하여 회원번호 목록을 조회합니다.\ > \---\ > \## 수정번호\ > \* Release v1.03\_231106: 휴대폰번호로 회원정보 조회 API 개발
```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/member/getMbrNoByCellNo":{"get":{"tags":["회원공통"],"summary":"선물수신자 회원번호 조회","description":"## 기능설명\n* 선물하기 서비스를 이용하기 위해 회원 번호를 조회합니다.\n---\n## 상세설명\n* 휴대폰번호를 입력하여 회원번호 목록을 조회합니다.\n---\n## 수정번호\n* Release v1.03_231106: 휴대폰번호로 회원정보 조회 API 개발\n","operationId":"getMbrNoListByCellNo","parameters":[{"name":"cellNoToMbrNoRequest","in":"query","description":"회원 전화번호 정보","required":true,"schema":{"type":"string","description":"CellNoToMbrNoRequest"}},{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CellNoToMbrNoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CellNoToMbrNoResponse":{"type":"object","properties":{"mbrNoList":{"type":"array","description":"회원번호","items":{"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"}}}}}} ``` ## 비회원 정보 조회 > \## 기능설명\ > \* 비회원 정보를 조회합니다.\ > \---\ > \## 상세설명\ > \* 비회원 정보를 조회합니다.\ > \* 비회원은 회원번호 "999999999"로 관리됩니다.
```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/front/nonMemberInfo":{"get":{"tags":["회원공통"],"summary":"비회원 정보 조회","description":"## 기능설명\n* 비회원 정보를 조회합니다.\n---\n## 상세설명\n* 비회원 정보를 조회합니다.\n* 비회원은 회원번호 \"999999999\"로 관리됩니다.\n","operationId":"getMemberInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MemberInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberInfo":{"type":"object","description":"회원번호 조회 Response","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)","enum":["GREEN","FAMILY","GOLD","VIP","VVIP"]},"mbrGradeNm":{"type":"string","description":"회원등급명(ME008)"},"mbrGbCd":{"type":"string","description":"회원구분코드(ME001)","enum":["MEMBER","NO_MEMBER"]},"mbrGbNm":{"type":"string","description":"회원구분명"},"mbrMgrCd":{"type":"string","description":"회원관리코드 (ME002)","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"mbrMgrNm":{"type":"string","description":"회원관리명"},"brth":{"type":"string","description":"생년월일"},"sexGbCd":{"type":"string","description":"성별구분코드 (ME017)","enum":["MALE","FEMALE"]},"sexGbNm":{"type":"string","description":"성별구분"},"nafrGbCd":{"type":"string","description":"내외국인구분코드 (ME018)","enum":["CITIZEN_MEMBER","FOREIGN_MEMBER"]},"nafrGbNm":{"type":"string","description":"내외국인구분명"},"stafYn":{"type":"string","description":"임직원여부"},"comGbCd":{"type":"string","description":"임직원 회사구분코드 (ME038)"},"comGbNm":{"type":"string","description":"임직원 회사구분명"},"frstLoginDtm":{"type":"string","format":"date-time","description":"최초로그인일시 (최초로그인 정보가 없으면 첫로그인 이벤트 대상)"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"주소"},"dtlAddr":{"type":"string","description":"상세주소"},"cellSctNo":{"type":"string","description":"핸드폰구분번호"},"cellTxnoNo":{"type":"string","description":"핸드폰국번번호"},"cellEndNo":{"type":"string","description":"핸드폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"emailAddr":{"type":"string","description":"이메일"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신 동의 여부"},"smsRecvAgrYn":{"type":"string","description":"문자 수신 동의 여부"},"appPushAgrYn":{"type":"string","description":"APP PUSH 동의여부"},"kakaoRecvAgrYn":{"type":"string","description":"카카오톡 수신동의 여부"},"histStrDt":{"type":"string","description":"현재 등급기준 시작일자"},"histEndDt":{"type":"string","description":"현재 등급기준 종료일자"},"smpctAcctLinkGbCd":{"type":"string","description":"간편계정연동구분코드 (ME052)","enum":["KAKAOTALK","NAVER","GOOGLE","APPLE"]},"smpctAcctLinkGbNm":{"type":"string","description":"간편계정연동구분명"},"frstOrdDt":{"type":"string","description":"최초주문일자"},"lstOrdDt":{"type":"string","description":"최종주문일자"},"loginCnt":{"type":"integer","format":"int32","description":"로그인횟수"},"ordCnt":{"type":"integer","format":"int32","description":"주문수"},"mbrJoinDtm":{"type":"string","format":"date-time","description":"회원가입일자"},"ordLmtYn":{"type":"string","description":"구매제한여부"},"ciCtacValYn":{"type":"string","description":"Ci인증정보여부"},"pwdChgDtm":{"type":"string","format":"date-time","description":"비밀번호변경일시"},"mgrGbCd":{"type":"string","description":"관리구분코드(ME019)"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"bmanNm":{"type":"string","description":"사업자명"},"bmanRegDt":{"type":"string","description":"사업자등록일자"},"rpstmnNm":{"type":"string","description":"대표자명"},"bmanRegFileNm":{"type":"string","description":"파일명"},"repTelSctNo":{"type":"string","description":"대표전화구분번호"},"repTelTxnoNo":{"type":"string","description":"대표전화국번번호"},"repTelEndNo":{"type":"string","description":"대표전화끝번호"},"bplcZipNo":{"type":"string","description":"사업자우편번호"},"bplcZipAddr":{"type":"string","description":"사업자주소"},"bplcDtlAddr":{"type":"string","description":"사업자상세주소"},"sysProcId":{"type":"string","description":"시스템처리ID"},"aprvRtrnCaus":{"type":"string","description":"가입반려사유"},"mbrStatCd":{"type":"string","description":"회원상태코드(ME003)"},"aempNm":{"type":"string","description":"담당자명"},"aempCellSctNo":{"type":"string","description":"담당자 휴대전화구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자 휴대전화국번번호"},"aempCellEndNo":{"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"}}}}}} ``` ## 회원 정보 조회(미마스킹) > \## 기능설명\ > \* 마스킹 되지 않은 회원의 정보를 조회합니다.\ > \---\ > \## 상세설명\ > \* 로그인은 필수입니다.\ > \* 회원 등급은 매달 산정됩니다.\ > \* 마스킹 목록\ > \* 생년월일\ > \* 회원명\ > \* 주소\ > \* 상세주소\ > \* 핸드폰국번번호\ > \* 이메일\ > \## 수정번호\ > \* \`\`\`(TEMP)MOON Project\`\`\`: Response 카카오톡 수신동의 추가
````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/front/memberInfo":{"get":{"tags":["회원공통"],"summary":"회원 정보 조회(미마스킹)","description":"## 기능설명\n* 마스킹 되지 않은 회원의 정보를 조회합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 회원 등급은 매달 산정됩니다.\n* 마스킹 목록\n * 생년월일\n * 회원명\n * 주소\n * 상세주소\n * 핸드폰국번번호\n * 이메일\n## 수정번호\n* ```(TEMP)MOON Project```: Response 카카오톡 수신동의 추가\n","operationId":"getMemberInfo_1","parameters":[{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MemberInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberInfo":{"type":"object","description":"회원번호 조회 Response","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)","enum":["GREEN","FAMILY","GOLD","VIP","VVIP"]},"mbrGradeNm":{"type":"string","description":"회원등급명(ME008)"},"mbrGbCd":{"type":"string","description":"회원구분코드(ME001)","enum":["MEMBER","NO_MEMBER"]},"mbrGbNm":{"type":"string","description":"회원구분명"},"mbrMgrCd":{"type":"string","description":"회원관리코드 (ME002)","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"mbrMgrNm":{"type":"string","description":"회원관리명"},"brth":{"type":"string","description":"생년월일"},"sexGbCd":{"type":"string","description":"성별구분코드 (ME017)","enum":["MALE","FEMALE"]},"sexGbNm":{"type":"string","description":"성별구분"},"nafrGbCd":{"type":"string","description":"내외국인구분코드 (ME018)","enum":["CITIZEN_MEMBER","FOREIGN_MEMBER"]},"nafrGbNm":{"type":"string","description":"내외국인구분명"},"stafYn":{"type":"string","description":"임직원여부"},"comGbCd":{"type":"string","description":"임직원 회사구분코드 (ME038)"},"comGbNm":{"type":"string","description":"임직원 회사구분명"},"frstLoginDtm":{"type":"string","format":"date-time","description":"최초로그인일시 (최초로그인 정보가 없으면 첫로그인 이벤트 대상)"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"주소"},"dtlAddr":{"type":"string","description":"상세주소"},"cellSctNo":{"type":"string","description":"핸드폰구분번호"},"cellTxnoNo":{"type":"string","description":"핸드폰국번번호"},"cellEndNo":{"type":"string","description":"핸드폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"emailAddr":{"type":"string","description":"이메일"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신 동의 여부"},"smsRecvAgrYn":{"type":"string","description":"문자 수신 동의 여부"},"appPushAgrYn":{"type":"string","description":"APP PUSH 동의여부"},"kakaoRecvAgrYn":{"type":"string","description":"카카오톡 수신동의 여부"},"histStrDt":{"type":"string","description":"현재 등급기준 시작일자"},"histEndDt":{"type":"string","description":"현재 등급기준 종료일자"},"smpctAcctLinkGbCd":{"type":"string","description":"간편계정연동구분코드 (ME052)","enum":["KAKAOTALK","NAVER","GOOGLE","APPLE"]},"smpctAcctLinkGbNm":{"type":"string","description":"간편계정연동구분명"},"frstOrdDt":{"type":"string","description":"최초주문일자"},"lstOrdDt":{"type":"string","description":"최종주문일자"},"loginCnt":{"type":"integer","format":"int32","description":"로그인횟수"},"ordCnt":{"type":"integer","format":"int32","description":"주문수"},"mbrJoinDtm":{"type":"string","format":"date-time","description":"회원가입일자"},"ordLmtYn":{"type":"string","description":"구매제한여부"},"ciCtacValYn":{"type":"string","description":"Ci인증정보여부"},"pwdChgDtm":{"type":"string","format":"date-time","description":"비밀번호변경일시"},"mgrGbCd":{"type":"string","description":"관리구분코드(ME019)"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"bmanNm":{"type":"string","description":"사업자명"},"bmanRegDt":{"type":"string","description":"사업자등록일자"},"rpstmnNm":{"type":"string","description":"대표자명"},"bmanRegFileNm":{"type":"string","description":"파일명"},"repTelSctNo":{"type":"string","description":"대표전화구분번호"},"repTelTxnoNo":{"type":"string","description":"대표전화국번번호"},"repTelEndNo":{"type":"string","description":"대표전화끝번호"},"bplcZipNo":{"type":"string","description":"사업자우편번호"},"bplcZipAddr":{"type":"string","description":"사업자주소"},"bplcDtlAddr":{"type":"string","description":"사업자상세주소"},"sysProcId":{"type":"string","description":"시스템처리ID"},"aprvRtrnCaus":{"type":"string","description":"가입반려사유"},"mbrStatCd":{"type":"string","description":"회원상태코드(ME003)"},"aempNm":{"type":"string","description":"담당자명"},"aempCellSctNo":{"type":"string","description":"담당자 휴대전화구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자 휴대전화국번번호"},"aempCellEndNo":{"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"}}}}}} ```` ## 회원 정보 조회(마스킹) > \## 기능설명\ > \* 마스킹된 않은 회원의 정보를 조회합니다.\ > \---\ > \## 상세설명\ > \* 로그인은 필수입니다.\ > \* 회원 등급은 매달 산정됩니다.\ > \* 마스킹 목록\ > \* 생년월일\ > \* 회원명\ > \* 주소\ > \* 상세주소\ > \* 핸드폰국번번호\ > \* 이메일
```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/front/loginInfo":{"get":{"tags":["회원공통"],"summary":"회원 정보 조회(마스킹)","description":"## 기능설명\n* 마스킹된 않은 회원의 정보를 조회합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 회원 등급은 매달 산정됩니다.\n* 마스킹 목록\n * 생년월일\n * 회원명\n * 주소\n * 상세주소\n * 핸드폰국번번호\n * 이메일\n","operationId":"getLoginInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MaskingMemberInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MaskingMemberInfo":{"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드 (ME008)","enum":["GREEN","FAMILY","GOLD","VIP","VVIP"]},"mbrGradeNm":{"type":"string","description":"회원등급명 (ME008)"},"mbrGbCd":{"type":"string","description":"회원구분코드 (ME001 - 10:정회원, 99:비회원)","enum":["MEMBER","NO_MEMBER"]},"mbrGbNm":{"type":"string","description":"회원구분명"},"mbrMgrCd":{"type":"string","description":"회원관리코드 (ME002 - 10:통합회원, 20:일반회원, 30:소셜회원, 99:비회원)","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"mbrMgrNm":{"type":"string","description":"회원관리명"},"brth":{"type":"string","description":"생년월일"},"sexGbCd":{"type":"string","description":"성별구분코드 (ME017 - M:남, F:여)","enum":["MALE","FEMALE"]},"sexGbNm":{"type":"string","description":"성별구분"},"nafrGbCd":{"type":"string","description":"내외국인구분코드 (ME018 - 10:내국인, 20:외국인)","enum":["CITIZEN_MEMBER","FOREIGN_MEMBER"]},"nafrGbNm":{"type":"string","description":"내외국인구분명"},"stafYn":{"type":"string","description":"임직원여부"},"comGbCd":{"type":"string","description":"임직원 회사구분코드 (ME038)"},"comGbNm":{"type":"string","description":"임직원 회사구분명"},"frstLoginDtm":{"type":"string","format":"date-time","description":"최초로그인일시 (최초로그인 정보가 없으면 첫로그인 이벤트 대상)"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"주소"},"dtlAddr":{"type":"string","description":"상세주소"},"cellSctNo":{"type":"string","description":"핸드폰구분번호"},"cellTxnoNo":{"type":"string","description":"핸드폰국번번호"},"cellEndNo":{"type":"string","description":"핸드폰끝번호"},"emailAddr":{"type":"string","description":"이메일"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신 동의 여부"},"smsRecvAgrYn":{"type":"string","description":"문자 수신 동의 여부"},"histStrDt":{"type":"string","description":"현재 등급기준 시작일자"},"histEndDt":{"type":"string","description":"현재 등급기준 종료일자"},"smpctAcctLinkGbCd":{"type":"string","description":"간편계정연동구분코드 (ME052)","enum":["KAKAOTALK","NAVER","GOOGLE","APPLE"]},"smpctAcctLinkGbNm":{"type":"string","description":"간편계정연동구분명"},"frstOrdDt":{"type":"string","description":"최초주문일자"},"lstOrdDt":{"type":"string","description":"최종주문일자"},"loginCnt":{"type":"integer","format":"int32","description":"로그인횟수"},"mbrJoinDtm":{"type":"string","format":"date-time","description":"회원가입일자"},"pwdChgDtm":{"type":"string","format":"date-time","description":"비밀번호변경일시"},"appPushAgrYn":{"type":"string","description":"APP PUSH 동의여부"},"ciCtacValYn":{"type":"string","description":"Ci인증정보여부"},"ordLmtYn":{"type":"string","description":"구매제한여부"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"bmanNm":{"type":"string","description":"사업자명"},"bmanRegDt":{"type":"string","description":"사업자등록일자"},"rpstmnNm":{"type":"string","description":"대표자명"},"repTelSctNo":{"type":"string","description":"대표전화구분번호"},"repTelTxnoNo":{"type":"string","description":"대표전화국번번호"},"repTelEndNo":{"type":"string","description":"대표전화끝번호"},"aprvRtrnCaus":{"type":"string","description":"가입반려사유"},"mbrStatCd":{"type":"string","description":"회원상태코드(ME003)"}}},"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"}}}}}} ``` --- # 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/store-front-api/member-api/undefined-2.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.