회원가입

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

회원가입 Request

idstringRequired

로그인 ID

Example: id001

cistringRequired

Ci 연계 값

Example: xksiajw77s221aZXSa

passwdstringOptional

비밀번호

brthstringRequired

생년월일 YYYYMMDD

Example: 19990101

namestringRequired

회원명

Example: 홍길동

sexCdstring · enumRequired

성별구분코드(ME017)

Example: MPossible values:

emailstringRequired

이메일

Example: id001@test.com

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

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

{
  "id": "id001",
  "ci": "xksiajw77s221aZXSa",
  "passwd": "text",
  "brth": 19990101,
  "name": "홍길동",
  "sexCd": "M",
  "email": "id001@test.com",
  "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

bmanRegFileMultipartFileRequired

사업자 증빙서류

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post/v1/member/enterpriseMemberJoin

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

{
  "memberJoinRequest": {
    "id": "id001",
    "ci": "xksiajw77s221aZXSa",
    "passwd": "text",
    "brth": 19990101,
    "name": "홍길동",
    "sexCd": "M",
    "email": "id001@test.com",
    "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

개인정보 수정 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: x2bee@plateer.com

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

POST /api/member/v1/member/checkMobileCert?memberInfoUpdateRequest=text HTTP/1.1
Host: api-member.x2bee.com/
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": "x2bee@plateer.com",
  "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

GET /api/member/v1/member/checkId?id=text HTTP/1.1
Host: api-member.x2bee.com/
Accept: */*

No content

이메일 중복 확인

get

기능설명

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

상세설명

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

Query parameters

mailInfoRequeststringRequired

MailInfoRequest

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

get/v1/member/checkEmail

GET /api/member/v1/member/checkEmail?mailInfoRequest=text HTTP/1.1
Host: api-member.x2bee.com/
Accept: */*

No content

이전본인인증 결과 다음본인인증호출

마지막 업데이트 5개월 전