> 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-3.md). # 아이디 비밀번호찾기 ## 비밀번호 찾기(바로 바꾸기) > \## 기능설명\ > \* 분실한 비밀번호를 새로운 비밀번호로 변경합니다.\ > \---\ > \## 상세설명\ > \* 고객이 비밀번호를 분실했을 때, 비밀번호 찾기를 통해 임시비밀번호를 발급 받는 방식이 아닌 고객이 새로운 비밀번호를 변경할 수 있도록 제공합니다.\ > \* 비밀번호 찾기 - 토큰 생성 API를 통해 발급 받은 인증 토큰을 활용하여 비밀번호를 변경합니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v1.03\_231106\`\`\`: 비밀번호 찾기 보안 방식 추가\ > \* \`\`\`Release v2.00\_250808\`\`\`: 사이트 번호 추가
````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/findPassword":{"put":{"tags":["아이디 비밀번호찾기"],"summary":"비밀번호 찾기(바로 바꾸기)","description":"## 기능설명\n* 분실한 비밀번호를 새로운 비밀번호로 변경합니다.\n---\n## 상세설명\n* 고객이 비밀번호를 분실했을 때, 비밀번호 찾기를 통해 임시비밀번호를 발급 받는 방식이 아닌 고객이 새로운 비밀번호를 변경할 수 있도록 제공합니다.\n* 비밀번호 찾기 - 토큰 생성 API를 통해 발급 받은 인증 토큰을 활용하여 비밀번호를 변경합니다.\n---\n## 수정번호\n* ```Release v1.03_231106```: 비밀번호 찾기 보안 방식 추가\n* ```Release v2.00_250808```: 사이트 번호 추가\n","operationId":"modifyFindPassword","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChgFindPwdRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ChgFindPwdRequest":{"type":"object","description":"비밀번호 바로 찾기 Request","properties":{"token":{"type":"string","description":"비밀번호 변경 토큰"},"pwd":{"type":"string","description":"비밀번호"},"mbrCertiTknGbCd":{"type":"string","description":"회원인증토큰구분코드(ME053)","enum":["REFRESH","AUTO_LOGIN","BIO_LOGIN","CHATBOT_LOGIN","CHG_PASSWORD"]}},"required":["mbrCertiTknGbCd"]},"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"}}}}}} ```` ## 비밀번호 수정 > \## 기능설명\ > \* 회원의 비밀번호를 변경합니다.\ > \---\ > \## 상세설명\ > \* 고객의 비밀번호를 변경합니다.\ > \* 비밀번호 변경 방식\ > \* 90일 후 비밀번호 변경 요청 시, 현재 비밀번호는 유지되며 회원의 비밀번호 변경 일자 정보가 업데이트됩니다.\ > \* 비밀번호 찾기 이후 최초 로그인한 경우 또는 개인정보 변경 페이지에서 비밀번호 검증을 통해 기존 비밀번호를 입력하지 않고 비밀번호를 변경할 수 있습니다.\ > \* 비밀번호 변경으로부터 90일이 지난 계정의 경우 기존 비밀번호를 입력하여 비밀번호를 변경할 수 있습니다.\ > \* 비밀번호 규칙\ > \* 8자 이상 30자 이하의 비밀번호 길이\ > \* 연속되지 않은 문자(ex 123, 456 ...)\ > \* 공백은 허용되지 않음\ > \* 동일한 문자 반복 허용되지 않음\ > \---\ > \## 특이사항\ > \* 기존 비밀번호와 동일한 비밀번호로는 변경할 수 없습니다.\ > \* 소셜계정의 경우 별도의 비밀번호가 존재하지 않으므로, 비밀번호 변경을 지원하지 않습니다.\ > \* 패스워드 변경 구분 코드를 통해 비밀번호 변경 서비스가 분기되어 처리됩니다.\ > \* chgGb 필드의 경우 10, 20, 30의 값만 허용됩니다.
```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/changePassword":{"put":{"tags":["아이디 비밀번호찾기"],"summary":"비밀번호 수정","description":"## 기능설명\n* 회원의 비밀번호를 변경합니다.\n---\n## 상세설명\n* 고객의 비밀번호를 변경합니다.\n* 비밀번호 변경 방식\n * 90일 후 비밀번호 변경 요청 시, 현재 비밀번호는 유지되며 회원의 비밀번호 변경 일자 정보가 업데이트됩니다.\n * 비밀번호 찾기 이후 최초 로그인한 경우 또는 개인정보 변경 페이지에서 비밀번호 검증을 통해 기존 비밀번호를 입력하지 않고 비밀번호를 변경할 수 있습니다.\n * 비밀번호 변경으로부터 90일이 지난 계정의 경우 기존 비밀번호를 입력하여 비밀번호를 변경할 수 있습니다.\n* 비밀번호 규칙\n * 8자 이상 30자 이하의 비밀번호 길이\n * 연속되지 않은 문자(ex 123, 456 ...)\n * 공백은 허용되지 않음\n * 동일한 문자 반복 허용되지 않음\n---\n## 특이사항\n* 기존 비밀번호와 동일한 비밀번호로는 변경할 수 없습니다.\n* 소셜계정의 경우 별도의 비밀번호가 존재하지 않으므로, 비밀번호 변경을 지원하지 않습니다.\n* 패스워드 변경 구분 코드를 통해 비밀번호 변경 서비스가 분기되어 처리됩니다.\n* chgGb 필드의 경우 10, 20, 30의 값만 허용됩니다.\n","operationId":"modifyPassword","parameters":[{"name":"request","in":"query","description":"회원 비밀번호 변경 정보","required":true,"schema":{"type":"string","description":"ChgPasswdRequest"}},{"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/ChgPasswdRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ChgPasswdRequest":{"type":"object","description":"비밀번호 변경 Request ","properties":{"mbrNo":{"type":"string","description":"회원번호"},"nowPwd":{"type":"string","description":"현재 패스워드"},"pwd":{"type":"string","description":"변경 패스워드"},"chgGb":{"type":"string","description":"패스워드 변경 구분"}},"required":["chgGb","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"}}}}}} ``` ## 비밀번호 찾기(토큰 생성) > \## 기능설명\ > \* 비밀번호 찾기를 위한 인증 토큰을 생성합니다.\ > \---\ > \## 상세설명\ > \* 고객이 비밀번호를 분실했을 때, 비밀번호 찾기를 통해 임시비밀번호를 발급 받는 방식이 아닌 고객이 새로운 비밀번호를 변경할 수 있도록 인증 토큰을 발급합니다.\ > \* 토큰의 유효기간은 5분입니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v1.03\_231106\`\`\`: 비밀번호 찾기 보안 방식 추가\ > \* \`\`\`Release v2.00\_250808\`\`\`: 사이트 번호 추가
````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/findPasswordToken":{"post":{"tags":["아이디 비밀번호찾기"],"summary":"비밀번호 찾기(토큰 생성)","description":"## 기능설명\n* 비밀번호 찾기를 위한 인증 토큰을 생성합니다.\n---\n## 상세설명\n* 고객이 비밀번호를 분실했을 때, 비밀번호 찾기를 통해 임시비밀번호를 발급 받는 방식이 아닌 고객이 새로운 비밀번호를 변경할 수 있도록 인증 토큰을 발급합니다.\n* 토큰의 유효기간은 5분입니다.\n---\n## 수정번호\n* ```Release v1.03_231106```: 비밀번호 찾기 보안 방식 추가\n* ```Release v2.00_250808```: 사이트 번호 추가\n","operationId":"insertFindPwdToken","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindPwdTokenRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FindPwdTokenResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"FindPwdTokenRequest":{"type":"object","description":"비밀번호 바로 찾기 Request","properties":{"loginId":{"type":"string","description":"로그인 아이디"},"ciCtacVal":{"type":"string","description":"CI 인증 정보"}}},"FindPwdTokenResponse":{"type":"object","description":"비밀번호 찾기 - 인증 토큰 생성 Response","properties":{"token":{"type":"string","description":"비밀번호 찾기 인증 토큰"},"mbrMgrCd":{"type":"string","description":"회원관리코드(ME002)","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]}},"required":["token"]},"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를 조회합니다.\ > \---\ > \## 특이사항\ > \* 조회한 아이디의 일부가 마스킹되어 전달됩니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v2.01\_250808\`\`\`: 사업자회원 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/findId":{"post":{"tags":["아이디 비밀번호찾기"],"summary":"아이디 찾기","description":"## 기능설명\n* 회원의 아이디를 조회합니다.\n---\n## 상세설명\n* 고객의 아이디를 분실했을 경우, 아이디 찾기를 통해 본인 계정의 ID를 조회합니다.\n---\n## 특이사항\n* 조회한 아이디의 일부가 마스킹되어 전달됩니다.\n---\n## 수정번호\n* ```Release v2.01_250808```: 사업자회원 ID 조회 추가\n","operationId":"getMemberFindId","parameters":[{"name":"findMemberIdRequest","in":"query","description":"아이디 찾기 요청을 위한 회원 정보","required":true,"schema":{"type":"string","description":"FindMemberIdRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindMemberIdRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FindMemberIdResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"FindMemberIdRequest":{"type":"object","description":"회원 아이디 찾기 Requewst DTO","properties":{"ciCtacVal":{"type":"string","description":"CI 연계 값"},"joinGbCd":{"type":"string","description":"가입구분코드(ME029)","enum":["CITIZEN_MEMBER","FOREIGN_MEMBER"]}},"required":["ciCtacVal","joinGbCd"]},"FindMemberIdResponse":{"type":"object","description":"회원 아이디 찾기 Response","properties":{"loginId":{"type":"string","description":"로그인 ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrMgrNm":{"type":"string","description":"회원유형(ME002)"},"mbrJoinDt":{"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 v2.00\_240401\`\`\`: 비밀번호 찾기 - 아이디 확인 추가\ > \* \`\`\`Release v2.01\_250808\`\`\`: 사이트 번호 추가
````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/checkLoginId":{"get":{"tags":["아이디 비밀번호찾기"],"summary":"비밀번호 찾기(아이디 확인)","description":"## 기능설명\n* 분실한 비밀번호를 새로운 비밀번호로 변경하기 전, 아이디 존재 여부를 확인합니다.\n---\n## 상세설명\n* 고객이 비밀번호를 분실했을 때, 비밀번호 변경 대상 아이디의 존재 유무를 확인합니다.\n---\n## 수정번호\n* ```Release v2.00_240401```: 비밀번호 찾기 - 아이디 확인 추가\n* ```Release v2.01_250808```: 사이트 번호 추가\n","operationId":"checkLoginId","parameters":[{"name":"loginId","in":"query","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"OK"}}}}}} ````