회원가입

회원가입

post

기능설명

• X2BEE 새로운 계정을 생성합니다.

---

상세설명

• 회원가입에는 일반 회원가입과 소셜회원으로 구분됩니다.

• 일반 회원 가입

  • 휴대폰 본인인증을 통해 개인 고유 정보와 필수 정보를 입력 후 가입하는 회원입니다.

• 소셜 회원 가입

  • 소셜사이트(네이버, 카카오)의 계정을 통해 개인 고유 정보를 제공 받고, 필수 정보를 입력 후 가입하는 회원입니다.

  • 소셜회원의 경우 회원의 비밀번호는 각 소셜 사이트의 비밀번호가 되며, 플래티어 사이트의 비밀번호는 입력하지 않습니다.

• 비밀번호 규칙

  • 8자 이상 30자 이하의 비밀번호 길이

  • 연속되지 않은 문자(ex 123, 456 ...)

  • 공백은 허용되지 않음

  • 동일한 문자 반복 허용되지 않음

---

특이사항

• 정상 등록 후 이벤트DB에 등록된 회원 정보를 동기화 처리합니다.

• 정상 등록 후 이벤트DB에 등록된 배송지순번 및 배송지 정보를 동기화 처리합니다.

---

수정번호

• Release v1.07_231228: 휴면회원여부 체크 로직 제거

• Release v2.00_250717: 전략 패턴 리팩토링

Query parameters

memberJoinRequeststringRequired

MemberJoinRequest

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

회원가입 Request

idstringRequired

로그인 ID

Example: id001

cistringRequired

Ci 연계 값

Example: xksiajw77s221aZXSa

passwdstringOptional

비밀번호

brthstringRequired

생년월일 YYYYMMDD

Example: 19990101

namestringRequired

회원명

Example: 홍길동

sexCdstring · enumRequired

성별구분코드(ME017)

Example: MPossible values:

emailstringRequired

이메일

Example: [e-mail]

agmtYnstring · enumRequired

약관 동의 여부

Example: YPossible values:

nafrGbCdstring · enumRequired

내/외국 구분코드 (ME018)

Example: 10Possible values:

smpctGbCdstring · enumOptional

소셜회원 연동구분코드(ME052)

Example: 10Possible values:

smpctGbIdstringOptional

소셜회원 고유 ID

Example: d1181542344

cellFirNostringRequired

휴대폰구분번호

Example: 010

cellSecNostringRequired

휴대폰 국번번호

Example: 1234

cellThirNostringRequired

휴대폰 마지막 번호

Example: 1234

zipNostringRequired

우편번호

Example: 05837

addrstringRequired

주소

Example: 서울 송파구 법원로9길 26

addrDtlstringRequired

상세주소

Example: 비지니스파크 D동 6층

bmanRegNostringRequired

사업자등록번호

Example: 1234567890

repTelSctNostringRequired

대표 전화 국번

Example: 02

repTelTxnoNostringRequired

대표 전화 중간번호

Example: 1234

repTelEndNostringRequired

대표 전화 끝번호

Example: 5678

rpstmnNmstringRequired

대표자명

Example: 홍길동

bmanRegDtstringRequired

개업일자

Example: 20240101

bmanNmstringRequired

사업장명

Example: 비지니스파크

bplcZipNostringRequired

사업장 우편번호

Example: 12345

bplcZipAddrstringRequired

사업장 주소

Example: 서울시 강남구 테헤란로 123

bplcDtlAddrstringRequired

사업장 상세주소

Example: 비지니스파크 D동 6층

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/member/memberJoin

HTTPcURLJavaScriptPython

POST /api/member/v1/member/memberJoin?memberJoinRequest=text HTTP/1.1
Host: localhost:8091/
Content-Type: application/json
Accept: */*
Content-Length: 689

{
  "id": "id001",
  "ci": "xksiajw77s221aZXSa",
  "passwd": "text",
  "brth": 19990101,
  "name": "홍길동",
  "sexCd": "M",
  "email": "[e-mail]",
  "joinAgrList": [
    {
      "mbrNo": "text",
      "svcAgrTypCd": "text",
      "agrYn": "text"
    }
  ],
  "agmtYn": "Y",
  "nafrGbCd": 10,
  "smpctGbCd": 10,
  "smpctGbId": "d1181542344",
  "cellFirNo": "010",
  "cellSecNo": 1234,
  "cellThirNo": 1234,
  "zipNo": "05837",
  "addr": "서울 송파구 법원로9길 26",
  "addrDtl": "비지니스파크 D동 6층",
  "bmanRegNo": 1234567890,
  "repTelSctNo": "02",
  "repTelTxnoNo": 1234,
  "repTelEndNo": 5678,
  "rpstmnNm": "홍길동",
  "bmanRegDt": 20240101,
  "bmanNm": "비지니스파크",
  "bplcZipNo": 12345,
  "bplcZipAddr": "서울시 강남구 테헤란로 123",
  "bplcDtlAddr": "비지니스파크 D동 6층"
}

No content

법인/사업장 회원가입

post

기능설명

• X2BEE 새로운 법인 계정을 생성합니다.

---

상세설명

• 법인 회원 가입

  • 사업장 인증을 통해 필수 정보를 입력 후 가입하는 회원

  • 승인 과정이 필요하므로 해당 프로세스에서는 요청으로 상태 만든다.

• 가입 규칙

  • 동일 사업장 번호로 여러개 가입 불가능

  • 이외에는 일반 회원과 동일한 조건

---

특이사항

• 정상 등록 후 신규가입 쿠폰발급은 회원가입 승인 프로세스에서 진행

Query parameters

memberJoinRequeststringRequired

MemberJoinRequest

bmanRegFileMultipartFileRequired

사업자 증빙서류

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

bmanRegFileMultipartFileRequired

사업자 증빙서류

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/member/enterpriseMemberJoin

HTTPcURLJavaScriptPython

POST /api/member/v1/member/enterpriseMemberJoin?memberJoinRequest=text&bmanRegFile=null HTTP/1.1
Host: localhost:8091/
Content-Type: application/json
Accept: */*
Content-Length: 730

{
  "memberJoinRequest": {
    "id": "id001",
    "ci": "xksiajw77s221aZXSa",
    "passwd": "text",
    "brth": 19990101,
    "name": "홍길동",
    "sexCd": "M",
    "email": "[e-mail]",
    "joinAgrList": [
      {
        "mbrNo": "text",
        "svcAgrTypCd": "text",
        "agrYn": "text"
      }
    ],
    "agmtYn": "Y",
    "nafrGbCd": 10,
    "smpctGbCd": 10,
    "smpctGbId": "d1181542344",
    "cellFirNo": "010",
    "cellSecNo": 1234,
    "cellThirNo": 1234,
    "zipNo": "05837",
    "addr": "서울 송파구 법원로9길 26",
    "addrDtl": "비지니스파크 D동 6층",
    "bmanRegNo": 1234567890,
    "repTelSctNo": "02",
    "repTelTxnoNo": 1234,
    "repTelEndNo": 5678,
    "rpstmnNm": "홍길동",
    "bmanRegDt": 20240101,
    "bmanNm": "비지니스파크",
    "bplcZipNo": 12345,
    "bplcZipAddr": "서울시 강남구 테헤란로 123",
    "bplcDtlAddr": "비지니스파크 D동 6층"
  },
  "bmanRegFile": null
}

No content

CI 인증 회원정보 조회

post

기능설명

• 본인인증 CI 연계 값을 통하여 기존 회원 정보를 조회합니다.

---

상세설명

• NICE 본인인증

  • 회원가입 과정 중 NICE 모바일 본인인증 과정을 통하여 전달 받은 CI 연계 값을 전달합니다.

  • 해당 데이터를 통해 기존 회원 가입 여부를 판단합니다.

• 제한사항

  • 기존에 가입되어 있는 회원의 경우 신규가입을 제한합니다.

---

특이사항

• 해당 API에서는, Request DTO 중 ciCtacVal 필드만 활용합니다.

Query parameters

memberInfoUpdateRequeststringRequired

MemberInfoUpdateRequest

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

개인정보 수정 Reqeust

mbrNostringOptional

회원번호

Example: 10000001

mbrNmstringOptional

회원명

Example: 임성현

mbrMgrCdstring · enumOptional

회원관리코드(ME002)

Example: 20Possible values:

ciCtacValstringOptional

Ci 연계 값

Example: xksiajw77s221aZXSa

cellPhoneFullNostringOptional

휴대폰 전체 번호

Example: 01012344321

cellPhoneFirNostringOptional

휴대폰 첫째 번호

Example: 010

cellPhoneSecNostringOptional

휴대폰 둘째 번호

Example: 1234

cellPhoneThirNostringOptional

휴대폰 셋째 번호

Example: 4321

zipNostringOptional

우편번호

Example: 04123

addressstringOptional

주소

Example: 문정동 H비즈니스 파크 D동

dtlAddressstringOptional

상세 주소

Example: 6층

dlvpNmstringOptional

배송지명

Example: 라운지

baseDlvpYnstringOptional

기본배송지여부

Example: Y

brthstringOptional

생년월일

Example: 19980704

sexGbCdstring · enumOptional

성별구분코드 (ME017) (글로벌 계정 전용)

Example: MPossible values:

emailAddrstringOptional

이메일주소

Example: [e-mail]

bmanNmstringRequired

사업장명

Example: 비지니스파크

repTelFullNostringRequired

대표 전화

Example: 02-1234-1234

repTelSctNostringRequired

대표 전화 국번

Example: 02

repTelTxnoNostringRequired

대표 전화 중간번호

Example: 1234

repTelEndNostringRequired

대표 전화 끝번호

Example: 5678

bplcZipNostringRequired

사업장 우편번호

Example: 12345

bplcZipAddrstringRequired

사업장 주소

Example: 서울시 강남구 테헤란로 123

bplcDtlAddrstringRequired

사업장 상세주소

Example: 비지니스파크 D동 6층

mbrStatCdstring · enumOptional

회원상태 코드

Example: 10Possible values:

aempNmstringOptional

담당자명

Example: 이상훈

aempCellFullNostringOptional

담당자 휴대폰 전체 번호

Example: 01012344321

aempCellSctNostringOptional

담당자 휴대전화구분번호

Example: 010

aempCellTxnoNostringOptional

담당자 휴대전화국번번호

Example: 1234

aempCellEndNostringOptional

담당자 휴대전화끝번호

Example: 4321

aempCiCtacValstringOptional

담당자 Ci 연계 값

Example: xksiajw77s221aZXSa

aempYnstringOptional

담당자 여부

Example: Y

joinSgtStatCdstring · enumOptional

가입 승인 여부

Example: MPossible values:

Responses

200

성공

*/*

회원 CI 인증 valid 체크 Response

ciCheckYnstringOptional

CI 인증여부

Example: N

900

업무처리 오류 내용

*/*

post

/v1/member/checkMobileCert

HTTPcURLJavaScriptPython

POST /api/member/v1/member/checkMobileCert?memberInfoUpdateRequest=text HTTP/1.1
Host: localhost:8091/
Content-Type: application/json
Accept: */*
Content-Length: 855

{
  "mbrNo": 10000001,
  "mbrNm": "임성현",
  "mbrMgrCd": 20,
  "ciCtacVal": "xksiajw77s221aZXSa",
  "cellPhoneFullNo": "01012344321",
  "cellPhoneFirNo": "010",
  "cellPhoneSecNo": 1234,
  "cellPhoneThirNo": 4321,
  "zipNo": "04123",
  "address": "문정동 H비즈니스 파크 D동",
  "dtlAddress": "6층",
  "mktRecvAgrList": [
    {
      "svcAgrTypCd": 10,
      "agrYn": "Y"
    }
  ],
  "dlvpNm": "라운지",
  "baseDlvpYn": "Y",
  "brth": 19980704,
  "sexGbCd": "M",
  "emailAddr": "[e-mail]",
  "bmanNm": "비지니스파크",
  "repTelFullNo": "02-1234-1234",
  "repTelSctNo": "02",
  "repTelTxnoNo": 1234,
  "repTelEndNo": 5678,
  "bplcZipNo": 12345,
  "bplcZipAddr": "서울시 강남구 테헤란로 123",
  "bplcDtlAddr": "비지니스파크 D동 6층",
  "mbrStatCd": 10,
  "aempNm": "이상훈",
  "aempCellFullNo": "01012344321",
  "aempCellSctNo": "010",
  "aempCellTxnoNo": 1234,
  "aempCellEndNo": 4321,
  "aempCiCtacVal": "xksiajw77s221aZXSa",
  "aempYn": "Y",
  "joinSgtStatCd": "M"
}

{
  "ciCheckYn": "N",
  "memberInfo": {
    "loginId": "x2bee",
    "mbrNo": 10000001
  }
}

아이디 중복 체크

get

기능설명

• X2BEE 아이디 중복 체크

---

상세설명

• 회원가입시 아이디 중복을 검증합니다.

---

특이사항

• checkLoginId와 반대로 중복이면 exception으로 판단합니다.

Query parameters

idstringRequired

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

get

/v1/member/checkId

HTTPcURLJavaScriptPython

GET /api/member/v1/member/checkId?id=text HTTP/1.1
Host: localhost:8091/
Accept: */*

No content

이메일 중복 확인

get

기능설명

• 기존 회원 중 동일한 이메일을 사용하고 있는 계정이 존재하는지 확인합니다.

---

상세설명

• 기존 사이트 회원 중 동일한 이메일을 사용하고 있는 계정이 존재하는지 여부를 확인합니다.

Query parameters

mailInfoRequeststringRequired

MailInfoRequest

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

get

/v1/member/checkEmail

HTTPcURLJavaScriptPython

GET /api/member/v1/member/checkEmail?mailInfoRequest=text HTTP/1.1
Host: localhost:8091/
Accept: */*

No content