회원 정보 관리

사업자 주소 수정

post

기능설명

• 사업자의 사업장 주소를 수정합니다.

---

상세설명

• 사업자의 사업장 주소를 수정합니다.

• 사업자 주소 수정 시 회원정보변경 이력을 추가합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requeststringRequired

MemberBusinessAddressChgRequest

Body

application/json

사업자 주소 저장 Request

mbrNostring · min: 1Required

회원번호

Example: 100000300

bplcZipNostring · min: 1Required

사업자 우편번호

Example: 05836

bplcZipAddrstring · min: 1Required

사업자 우편주소

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

bplcDtlAddrstring · min: 1Required

사업장주소

Example: 서울 송파구 법원로9길 26 에이치비지니스파크 D동 6층

Responses

200

성공

*/*

stringOptional

900

업무처리 오류 내용

*/*

post

/v1/member/memberMgmt/updateBmanAddress

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/memberMgmt/updateBmanAddress?request=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 177

{
  "mbrNo": 100000300,
  "bplcZipNo": "05836",
  "bplcZipAddr": "서울 송파구 법원로9길 26",
  "bplcDtlAddr": "서울 송파구 법원로9길 26 에이치비지니스파크 D동 6층"
}

text

환불 계좌 등록

post

기능설명

• 회원의 활불 계좌를 등록합니다.

---

상세설명

---

특이사항

• 예금주명은 회원명과 일치해야합니다.

• 계좌 인증이 환료되어야 합니다.

• 필수 값 목록

  • 계좌번호

  • 은행코드

  • 계좌 인증 유무

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

환불계좌 등록 Request

mbrNostringOptional

회원번호

Example: 10000001

rfdBankCdstringOptional

은행코드(OM026)

Example: 201

rfdActnNostringOptional

계좌번호

Example: 1111-22-000874

rfdActnDepositorNmstringOptional

환불계좌 예금주

Example: 홍길동

rfdActnCertiYnstringOptional

계좌 인증 유무

Example: Y

Responses

200

성공

*/*

stringOptional

900

업무처리 오류 내용

*/*

post

/v1/member/memberMgmt/saveMemberRefundActn

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/memberMgmt/saveMemberRefundActn HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "mbrNo": 10000001,
  "rfdBankCd": 201,
  "rfdActnNo": "1111-22-000874",
  "rfdActnDepositorNm": "홍길동",
  "rfdActnCertiYn": "Y"
}

text

회원 배송지 저장/수정/삭제

post

기능설명

• 배송지를 저장 or 수정 or 삭제합니다.

---

상세설명

• 회원의 배송지를 저장합니다.

• 회원의 배송지를 수정합니다.

• 회원의 배송지를 삭제합니다.

---

수정번호

• Release v1.06_231218: 배송지는 최대 공통코드 ST017의 참조1값까지 등록 가능합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

saveMemberDeliverystringRequired

SaveMemberDelivery

Body

application/json

회원 배송지 저장 및 삭제 Request

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/member/memberMgmt/saveMemberDelivery

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/memberMgmt/saveMemberDelivery?saveMemberDelivery=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2274

{
  "realGridCUD": {
    "all": [
      {
        "mbrNo": 100001731,
        "mbrDlvpSeq": 1,
        "dlvpNm": "회사",
        "rcvmnNm": "플래티어",
        "baseDlvpYn": "Y",
        "zipNoSeq": 0,
        "zipNo": "05836",
        "zipAddr": "서울 송파구 문정동 법원로 9길 26",
        "dtlAddr": "에이치비지니스파크 D동 6층 플래티어",
        "emailAddr": "[e-mail]",
        "cellSctNo": "010",
        "cellTxnoNo": 1234,
        "cellEndNo": 1234,
        "telRgnNo": "02",
        "telTxnoNo": 123,
        "telEndNo": 1234,
        "deliMsgCd": 10,
        "deliMsg": "부재 시 연락주세요",
        "comnFrdrCogoMethodCd": 10,
        "comnFrdrEtcMethod": "경비실 호출 하세요",
        "comnFrdrPwd": 12345,
        "useYn": "Y",
        "userSortSeq": 0
      }
    ],
    "create": [
      {
        "mbrNo": 100001731,
        "mbrDlvpSeq": 1,
        "dlvpNm": "회사",
        "rcvmnNm": "플래티어",
        "baseDlvpYn": "Y",
        "zipNoSeq": 0,
        "zipNo": "05836",
        "zipAddr": "서울 송파구 문정동 법원로 9길 26",
        "dtlAddr": "에이치비지니스파크 D동 6층 플래티어",
        "emailAddr": "[e-mail]",
        "cellSctNo": "010",
        "cellTxnoNo": 1234,
        "cellEndNo": 1234,
        "telRgnNo": "02",
        "telTxnoNo": 123,
        "telEndNo": 1234,
        "deliMsgCd": 10,
        "deliMsg": "부재 시 연락주세요",
        "comnFrdrCogoMethodCd": 10,
        "comnFrdrEtcMethod": "경비실 호출 하세요",
        "comnFrdrPwd": 12345,
        "useYn": "Y",
        "userSortSeq": 0
      }
    ],
    "update": [
      {
        "mbrNo": 100001731,
        "mbrDlvpSeq": 1,
        "dlvpNm": "회사",
        "rcvmnNm": "플래티어",
        "baseDlvpYn": "Y",
        "zipNoSeq": 0,
        "zipNo": "05836",
        "zipAddr": "서울 송파구 문정동 법원로 9길 26",
        "dtlAddr": "에이치비지니스파크 D동 6층 플래티어",
        "emailAddr": "[e-mail]",
        "cellSctNo": "010",
        "cellTxnoNo": 1234,
        "cellEndNo": 1234,
        "telRgnNo": "02",
        "telTxnoNo": 123,
        "telEndNo": 1234,
        "deliMsgCd": 10,
        "deliMsg": "부재 시 연락주세요",
        "comnFrdrCogoMethodCd": 10,
        "comnFrdrEtcMethod": "경비실 호출 하세요",
        "comnFrdrPwd": 12345,
        "useYn": "Y",
        "userSortSeq": 0
      }
    ],
    "delete": [
      {
        "mbrNo": 100001731,
        "mbrDlvpSeq": 1,
        "dlvpNm": "회사",
        "rcvmnNm": "플래티어",
        "baseDlvpYn": "Y",
        "zipNoSeq": 0,
        "zipNo": "05836",
        "zipAddr": "서울 송파구 문정동 법원로 9길 26",
        "dtlAddr": "에이치비지니스파크 D동 6층 플래티어",
        "emailAddr": "[e-mail]",
        "cellSctNo": "010",
        "cellTxnoNo": 1234,
        "cellEndNo": 1234,
        "telRgnNo": "02",
        "telTxnoNo": 123,
        "telEndNo": 1234,
        "deliMsgCd": 10,
        "deliMsg": "부재 시 연락주세요",
        "comnFrdrCogoMethodCd": 10,
        "comnFrdrEtcMethod": "경비실 호출 하세요",
        "comnFrdrPwd": 12345,
        "useYn": "Y",
        "userSortSeq": 0
      }
    ]
  }
}

No content

임직원 등록

post

기능설명

• 회원을 임직원으로 등록합니다.

---

상세설명

• 회원을 임직원으로 등록합니다.

• 동일한 회사에 동일한 사번을 등록할 수 없습니다.

---

수정번호

• Release v1.03_231106:

  • 임직원 최초 등록 시 임직원 할인한도, 임직원 할인한도 이력 테이블에 INSERT

  • 임직원 재등록 시 임직원 할인한도 테이블 USE_YN 값 'N'으로 UPDATE

  • 타 회사 임직원 재등록 시 기존 회사 잔여 임직원 할인한도 전부 소진처리, 새 회사 이력 테이블 INSERT

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

임직원 등록 Request

mbrNostringOptional

회원번호

Example: 1000001

stafMgrNostringOptional

사번

Example: 1001

comGbCdstringOptional

회사구분코드

Example: P00

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/member/memberMgmt/modifyStaf

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/memberMgmt/modifyStaf HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "mbrNo": 1000001,
  "stafMgrNo": 1001,
  "comGbCd": "P00"
}

No content

회원 연락처 저장

post

기능설명

• 회원 연락처 정보를 저장합니다.

---

상세설명

• 회원의 연락처 정보를 저장합니다.

• 회원 연락처 정보

  • 이메일주소

  • 전화번호

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requeststringRequired

MemberContactChgRequest

Body

application/json

회원연락처 정보 저장 Request

mbrNostringOptional

회원번호

Example: 100000300

emailAddrstringOptional

이메일주소

Example: [e-mail]

telRgnNostringOptional

전화지역번호

Example: 02

telTxnoNostringOptional

전화국번번호

Example: 123

telEndNostringOptional

전화끝번호

Example: 1234

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/member/memberMgmt/memberUpdateContact

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/memberMgmt/memberUpdateContact?request=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 223

{
  "mbrNo": 100000300,
  "emailAddr": "[e-mail]",
  "telRgnNo": "02",
  "telTxnoNo": 123,
  "telEndNo": 1234,
  "etMbrInfoChgHistList": [
    {
      "mbrInfoChgSeq": "text",
      "mbrNo": 100000300,
      "chgTgtTypCd": "02",
      "chgCont": "임시비밀번호발급"
    }
  ]
}

No content

회원 주소 저장

post

기능설명

• 회원의 주소를 저장합니다.

---

상세설명

• 회원의 개인정보 중 주소를 저장합니다.

• 개인정보 수정 시 회원정보변경 이력을 추가합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requeststringRequired

MemberAddressChgRequest

Body

application/json

회원 주소 저장 Request

mbrNostringOptional

회원번호

Example: 100000300

zipNoSeqinteger · int64Optional

우편번호순번

Example: 0

zipNostringOptional

우편번호

Example: 05836

zipAddrstringOptional

우편주소

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

dtlAddrstringOptional

상세주소

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

nafrGbCdstringOptional

국내10,해외20

Example: 10

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/member/memberMgmt/memberUpdateAddress

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/memberMgmt/memberUpdateAddress?request=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 276

{
  "mbrNo": 100000300,
  "zipNoSeq": 0,
  "zipNo": "05836",
  "zipAddr": "서울 송파구 법원로9길 26",
  "dtlAddr": "에이치비지니스파크 D동 6층",
  "nafrGbCd": 10,
  "etMbrInfoChgHist": {
    "mbrInfoChgSeq": "text",
    "mbrNo": 100000300,
    "chgTgtTypCd": "02",
    "chgCont": "임시비밀번호발급"
  }
}

No content

비밀번호 초기화

post

기능설명

• 비밀번호를 초기화 합니다.

---

상세설명

• 회원의 비밀번호를 초기화 합니다.

• 고객이 비밀번호를 분실 했을 때, 임의로 문자를 조합하여 비밀번호를 설정하여 회원이 등록한 전화번호로 비밀번호를 전달합니다.

• 임시비밀번호는 10자리의 대문자, 소문자, 숫자를 조합하여 생성됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requeststringRequired

MemberInitPwdRequest

Body

application/json

비밀번호 초기화 Request

loginIdstringOptional

로그인아이디

Example: venus17

mbrNostringOptional

회원번호

Example: 100000300

pwdIniCausContstringOptional

패스워드초기화사유

Example: 비밀번호 분실

Responses

200

성공

*/*

stringOptional

900

업무처리 오류 내용

*/*

post

/v1/member/memberMgmt/initializePassword

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/memberMgmt/initializePassword?request=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "loginId": "venus17",
  "mbrNo": 100000300,
  "pwdIniCausCont": "비밀번호 분실"
}

text

동의이력 목록 조회

get

기능설명

• 회원의 동의이력 목록을 조회합니다.

---

상세설명

• 회원의 마케팅 동의이력 목록을 조회합니다.

• 회원이 마케팅 동의이력을 변경할때 마다 이력이 쌓입니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

MemberDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v2/member/memberMgmt/getAgreeHistory

HTTPcURLJavaScriptPython

GET /api/bo/v2/member/memberMgmt/getAgreeHistory?request=[object+Object]&MemberDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "siteNm": "플래티어닷컴",
      "svcAgrTypNm": "이메일수신동의",
      "agrYn": "Y",
      "sysRegDtm": "2023-05-11 12:30:00"
    }
  ]
}

마케팅/서비스 동의 목록 조회

get

기능설명

• 회원의 마케팅/서비스 동의 목록을 조회합니다.

---

상세설명

• 회원의 마케팅/서비스 동의 목록 건수를 조회합니다.

• 동의 목록

  • SMS 수신동의

  • 이메일 수신동의

  • PUSH 수신동의

수정번호

• Release_240125_01: 카카오 수신동의 추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ServiceAgreeHistRequeststringRequired

ServiceAgreeHistRequest

Responses

200

성공

*/*

마케팅/서비스 동의목록 Response

siteNmstringOptional

사이트명

Example: 플래티어닷컴

smsRecvAgrYnstringOptional

SMS수신동의

Example: Y

emailRecvAgrYnstringOptional

이메일수신동의

Example: Y

appPushAgrYnstringOptional

PUSH수신동의

Example: Y

kakaoRecvAgrYnstringOptional

KAKAO수신동의

Example: Y

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getServiceAgreeHist

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getServiceAgreeHist?request=[object+Object]&ServiceAgreeHistRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "siteNm": "플래티어닷컴",
    "smsRecvAgrYn": "Y",
    "emailRecvAgrYn": "Y",
    "appPushAgrYn": "Y",
    "kakaoRecvAgrYn": "Y"
  }
]

마케팅/서비스 동의 목록 건수 조회

get

기능설명

• 회원의 마케팅/서비스 동의 목록 건수를 조회합니다.

---

상세설명

• 회원의 마케팅/서비스 동의 목록 건수를 조회합니다.

• 동의 목록

  • SMS 수신동의

  • 이메일 수신동의

  • PUSH 수신동의

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ServiceAgreeHistRequeststringRequired

ServiceAgreeHistRequest

Responses

200

성공

*/*

integer · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getServiceAgreeHistCount

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getServiceAgreeHistCount?request=[object+Object]&ServiceAgreeHistRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

상품리뷰 목록 조회

get

기능설명

• 회원의 상품리뷰 목록을 조회합니다.

---

상세설명

• 회원이 진행한 상품리뷰 목록을 조회합니다.

• 회원이 진행한 상품리뷰 목록 건수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

GoodsReviewRequeststringRequired

GoodsReviewRequest

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getProductReview

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getProductReview?request=[object+Object]&GoodsReviewRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "revNo": "text",
      "revCont": "text",
      "revGbCd": 10,
      "revGbNm": "text",
      "ansCont": "text",
      "revContCnt": "text",
      "reco": "text",
      "replyCnt": "text",
      "goodsNo": "text",
      "goodsNm": "text",
      "revScrVal": "text",
      "ansCnt": 1
    }
  ]
}

상품QA 목록 조회

get

기능설명

• 회원의 상품QA 목록을 조회합니다.

---

상세설명

• 회원이 진행한 상품QA 목록을 조회합니다.

• 회원이 잔행한 상품QA 목록 건수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

GoodsQaRequeststringRequired

GoodsQaRequest

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getProductQa

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getProductQa?request=[object+Object]&GoodsQaRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "questNo": "text",
      "questTypCdNm": "text",
      "procStatCdNm": "text",
      "questCont": "상품문의",
      "mdId": "text"
    }
  ]
}

참여이벤트목록 조회

get

기능설명

• 회원 참여 이벤트 목록을 조회합니다.

---

상세설명

• 회원 참여 이벤트 목록을 조회합니다.

• 회원 참여 이벤트 목록 건수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getParticipationEvent

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getParticipationEvent?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "evtNo": "text",
      "evtNm": "text",
      "aplyDt": "text",
      "strDt": "text",
      "endDt": "text",
      "evtPrgsStatCd": "text",
      "evtPrgsStatNm": "text",
      "winDt": "text",
      "winYn": "text"
    }
  ]
}

내/외국인 여부 조회

get

기능설명

• 내/외국인 여부 조회

---

상세설명

• 회원의 내/외국인 여부를 조회합니다.

---

특이사항

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

stringOptional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getNafrGbNmYn

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getNafrGbNmYn?request=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

text

마일리지 목록 조회

get

기능설명

• 회원의 마일리지 목록을 조회합니다.

---

상세설명

• 회원의 마일리지 목록을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

anyRequired

Responses

200

성공

*/*

마일리지 목록 조회 Response

astRsrvUseGbNmstringOptional

구분

Example: 적립

astRsrvUseCausNmstringOptional

사유

Example: 주문적립

ocurDtmstring · date-timeOptional

처리일시

Example: 2023-01-01 12:00:00

ocurAmtnumberOptional

발생/사용금액

Example: 1000

balAmtnumberOptional

잔액

Example: 1000

astMgrNostringOptional

관련번호

Example: 1

valiEndDtstringOptional

사용종료일시

Example: 2023-01-01

astMgrMemostringOptional

메모

Example: Text

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMilgHistory

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMilgHistory?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "astRsrvUseGbNm": "적립",
    "astRsrvUseCausNm": "주문적립",
    "ocurDtm": "2023-01-01 12:00:00",
    "ocurAmt": 1000,
    "balAmt": 1000,
    "astMgrNo": 1,
    "valiEndDt": "2023-01-01",
    "astMgrMemo": "Text"
  }
]

환불 계좌 정보 조회

get

기능설명

• 회원의 환불 계좌 정보를 조회합니다.

---

상세설명

• 회원의 환불 계좌 정보를 조회합니다.

• 유효한 권한이 없으면 계좌 정보는 마스킹됩니다.

• 비회원인 경우 주문번호에 해당하는 환불 계좌 정보를 조회합니다.

• 마스킹 목록

  • 회원명

  • 환불 계좌번호

  • 환불 계좌 예금주

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

MemberDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

환불 계좌 정보 Response

mbrNostringOptional

회원번호

Example: 10000001

mbrNmstringOptional

회원명

Example: 홍길동

rfdActnNostringOptional

환불계좌번호

Example: 11111-00-124111

rfdActnDepositorNmstringOptional

환불계좌 예금주

Example: 홍길동

rfdActnCertiYnstringOptional

환불계좌 인증여부

Example: Y

rfdBankCdstringOptional

환불계좌 은행코드

Example: 201

loginIdstringOptional

회원아이디

Example: x2bee12

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberRefundActnInfo

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberRefundActnInfo?mbrDetailRequest=[object+Object]&MemberDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "mbrNo": 10000001,
  "mbrNm": "홍길동",
  "rfdActnNo": "11111-00-124111",
  "rfdActnDepositorNm": "홍길동",
  "rfdActnCertiYn": "Y",
  "rfdBankCd": 201,
  "loginId": "x2bee12"
}

회원 통관번호 조회 - 목록

get

기능설명

• 회원 통관번호 이력을 조회합니다.

---

상세설명

• 대상회원의 통관번호 조회 목록을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

회원 통관번호 조회 Response

mbrNostringOptional

회원번호

Example: 100000300

rcvmnNmstringOptional

수령인명

Example: 홍길동

cellPhonestringOptional

휴대폰번호

Example: 01012345678

zipNostringOptional

우편번호

Example: 12345

persCstmCdstringOptional

개인통관고유부호

Example: P1234567890123

sysRegIdstringOptional

등록자ID

Example: admin

sysRegDtmstringOptional

등록일시

Example: 2022-08-17 17:39:36

sysModIdstringOptional

수정자ID

Example: admin

sysModDtmstringOptional

수정일시

Example: 2022-08-17 17:39:36

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberPcccInfoListByMemberNoData

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberPcccInfoListByMemberNoData?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "mbrNo": 100000300,
    "rcvmnNm": "홍길동",
    "cellPhone": "01012345678",
    "zipNo": 12345,
    "persCstmCd": "P1234567890123",
    "sysRegId": "admin",
    "sysRegDtm": "2022-08-17 17:39:36",
    "sysModId": "admin",
    "sysModDtm": "2022-08-17 17:39:36"
  }
]

회원 목록 조회

get

기능설명

• 회원 목록을 조회합니다.

---

상세설명

• 전달 받은 조건 데이터를 통해 해당 조건에 해당되는 회원의 목록을 조회합니다.

• 조회 조건

  • 기간조회

    • 회원가입일자를 기준으로 시작일과 종료일을 설정하여 조회합니다.

    • 조회 기간은 30일을 초과 할 수 없습니다.

  • 전체기간 조회

    • 전체기간 조회 시 회원정보(회원명 or 회원번호 or 로그인ID) 혹은 휴대폰번호를 입력하여 조회합니다.

---

수정번호

• Release v1.07_231228: 휴면회원 로직 제거로 인해 Request(조회 조건) 에 회원상태코드 제거

• Release v2.00_240613: 기간 검색 조건 개선

• Release v2.00_240627: (ME025) 서비스 유형 카카오톡 추가로 인한 수정

• Release v2.00_250711: 사업자회원 조회 조건 추가 (사업자회원인 경우, 승인된 회원만 조회)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrMgmtSearchRequestMemberMgmtSearchRequestRequired

회원 목록 조회

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberList

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberList?mbrMgmtSearchRequest=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "mbrNo": 100000300,
      "socialNm": "네이버",
      "mbrNm": "홍*동",
      "mbrStatCd": 10,
      "loginId": "ven***************",
      "emailAddr": "ves*****@plateer.com",
      "cellNo": "010-****-1234",
      "zipAddr": "서울 송파구 ******",
      "dtlAddr": "***",
      "mbrJoinDtm": "2023-08-17 17:39:36",
      "sysModId": 999999999,
      "sysModDtm": "2023-09-12 17:39:36",
      "joinGbCd": 10,
      "mbrMgrCd": 99,
      "mbrMgrNm": "소셜회원",
      "mbrGradeNm": "GREEN",
      "mbrStatNm": "정상회원",
      "stafYn": "N",
      "mbrCareConsumeYn": "N",
      "siteNm": "x2bee",
      "smsRecvAgrYn": "N",
      "emailRecvAgrYn": "N",
      "appPushAgrYn": "N",
      "kakaoRecvAgrYn": "N"
    }
  ]
}

회원부가정보 조회

get

기능설명

• 회원의 부가정보를 조회합니다.

---

상세설명

• 회원의 부가정보를 조회합니다.

---

수정번호

• Release v2.00_240530: 소셜 추가(구글, 애플)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

MemberDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

회원부가정보 Response

mbrJoinDtmstring · date-timeOptional

회원가입일시

Example: 2023-01-01 12:30:00

lstLoginDtmstring · date-timeOptional

최종로그인일시

Example: 2023-01-01 12:30:00

lstOrdDtmstring · date-timeOptional

최종주문일시

Example: 2023-01-01 12:30:00

snsLinkYnstringOptional

SNS연동여부

Example: Y

snsLinkStrDtmstring · date-timeOptional

SNS연동일시

Example: 2023-01-01 12:30:00

siteNostringOptional

가입사이트번호

Example: 1

siteNmstringOptional

가입사이트명

Example: 플래티어닷컴

pwdChgDtmstringOptional

비밀번호변경일시

Example: 2023-01-01 12:30:00

stpRvcDtstringOptional

휴면해제일자

Example: 2023-01-01

lgcMbrNostringOptional

기간계회원번호

Example: 123456

mbrNostringOptional

회원번호

Example: 10000001

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberJoinInfo

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberJoinInfo?request=[object+Object]&MemberDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "mbrJoinDtm": "2023-01-01 12:30:00",
  "lstLoginDtm": "2023-01-01 12:30:00",
  "lstOrdDtm": "2023-01-01 12:30:00",
  "snsLinkYn": "Y",
  "snsLinkStrDtm": "2023-01-01 12:30:00",
  "siteNo": 1,
  "siteNm": "플래티어닷컴",
  "pwdChgDtm": "2023-01-01 12:30:00",
  "stpRvcDt": "2023-01-01",
  "lgcMbrNo": 123456,
  "mbrNo": 10000001,
  "snsLinkInfoList": [
    {
      "mbrNo": "text",
      "smpctAcctLinkGbCd": "text",
      "smpctAcctLinkGbCdNm": "text",
      "snsLinkYn": "text",
      "snsLinkStrDtm": "2026-02-27T18:14:19.431Z",
      "snsLinkEndDtm": "2026-02-27T18:14:19.431Z",
      "snsLinkId": "text",
      "snsMbrNo": "text",
      "rmkConts": "text"
    }
  ]
}

회원 상세 조회

get

기능설명

• 회원 상세 정보를 조회 합니다.

---

상세설명

• 회원의 개인정보 및 상세내용을 조회 합니다.

• 개인정보 마스킹 조건

  • 관리자의 개인정보 열람 권한이 없는 경우

  • 관리자의 개인정보 열람 권한은 있으나, 해당 항목에 대한 권한이 없는 경우

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberInfo

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberInfo?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "memberInfo": {
    "mbrNo": 100000300,
    "mbrNm": "플래티어",
    "loginId": "venus17",
    "id": "venus17",
    "mbrMgrCd": 10,
    "mbrGbNm": "정회원",
    "mbrMgrNm": "일반회원",
    "stafMgrNo": 2134,
    "instMbrYn": "N",
    "instMbrGb": "VIP/주문주의",
    "ordLmtYn": "N",
    "stafYn": "Y",
    "mbrStatCd": 10,
    "mbrStatNm": "정상회원",
    "mbrGradeNm": "GREEN",
    "solarYn": "Y",
    "brth": 19990101,
    "sexGbNm": "남",
    "nafrGbNm": "Y",
    "telNo": "02-123-1234",
    "telRgnNo": "02",
    "telTxnoNo": 123,
    "telEndNo": 1234,
    "cellNo": "010-1234-1234",
    "cellSctNo": "010",
    "cellTxnoNo": 1234,
    "cellEndNo": 1234,
    "emailAddr": "[e-mail]",
    "zipNoSeq": 0,
    "zipNo": "05836",
    "dtlAddr": "에이치비지니스파크 D동 6층",
    "zipAddr": "서울 송파구 법원로9길 26",
    "siteNo": 1,
    "joinGbNm": "국문",
    "adlCertiYn": "Y",
    "adlCertiDtm": "2023-08-17 17:39:36",
    "mbrJoinDtm": "2023-08-17 17:39:36",
    "frstOrdDtm": "2023-08-17 17:39:36",
    "lstOrdDtm": "2023-08-17 17:39:36",
    "frstLoginDtm": "2023-08-17 17:39:36",
    "lstLoginDtm": "2023-08-17 17:39:36",
    "mbrCertiGbNm": "본인인증",
    "pwdQuestCont": "text",
    "pwdAnsCont": "text",
    "pwdFailCnt": 1,
    "pwdIniYn": "N",
    "pwdChgDtm": "2023-08-17 17:39:36",
    "pwdIniCausCont": "비밀번호 분실",
    "ciCtacVal": "xksiajw77s221aZXSa",
    "stpProcDt": "2023-08-17 17:39:36",
    "stpRvcDt": "2023-08-17 17:39:36",
    "mbrWdraDtm": "2023-08-17 17:39:36",
    "mbrWdraCausCont": "사이트 이용 계획 없음",
    "comGbNm": "플래티어",
    "smpctAcctLinkGbCd": 20,
    "smpctAcctLinkGbNm": "카카오",
    "bmanRegNo": 1234567890123,
    "bmanRegDt": 20230817,
    "rpstmnNm": "홍길동",
    "repTelSctNo": "02-123-1234",
    "repTelTxnoNo": 123,
    "repTelEndNo": 1234,
    "repTelNo": 10,
    "bmanNm": "플래티어",
    "bplcZipNo": "05836",
    "bplcZipAddr": "서울 송파구 법원로9길 26",
    "bplcDtlAddr": "에이치비지니스파크 D동 6층",
    "atchFilePathNm": "https://www.plateer.com/attach/bman/1234567890123.jpg",
    "aempNm": "홍길동",
    "aempCellSctNo": "010",
    "aempCellTxnoNo": 1234,
    "aempCellEndNo": 1234
  },
  "realGridList": {
    "totalCount": 1,
    "payloads": [
      {
        "mbrNo": 100001731,
        "mbrDlvpSeq": 1,
        "dlvpNm": "회사",
        "rcvmnNm": "플래티어",
        "baseDlvpYn": "Y",
        "nafrGbNmYn": "Y",
        "zipNoSeq": 1,
        "zipNo": "05836",
        "zipAddr": "서울 송파구 문정동 법원로 9길 26",
        "dtlAddr": "에이치비지니스파크 D동 6층 플래티어",
        "emailAddr": "[e-mail]",
        "telNo": "02-123-1234",
        "telRgnNo": "02",
        "telTxnoNo": 123,
        "telEndNo": 1234,
        "cellNo": "010-1234-1234",
        "cellSctNo": "010",
        "cellTxnoNo": 1234,
        "cellEndNo": 1234,
        "deliMsgCd": 10,
        "deliMsgNm": "문 앞에 두고 가주세요.",
        "deliMsg": "부재 시 연락주세요",
        "comnFrdrCogoMethodCd": 10,
        "comnFrdrCogoMethodNm": "공통현관 출입번호",
        "comnFrdrEtcMethod": "경비실 호출 하세요",
        "comnFrdrPwd": 12345,
        "useYn": "Y",
        "sysRegId": 999999999,
        "sysRedDtm": "2023-08-17 17:39:36",
        "sysModId": 999999999,
        "sysModDtm": "2023-08-17 17:39:36"
      }
    ]
  }
}

회원 이력 목록 조회

get

기능설명

• 회원의 다양한 이력 목록을 동적으로 조회합니다.

---

상세설명

• 회원의 개인정보 변경 이력을 이력 유형에 따라 동적으로 조회할 수 있습니다.

• 주소(11), 휴대폰번호(12), 전화번호(13), 이메일(14) 등 다양한 이력 유형을 지원합니다.

• 이력 유형 리스트를 통해 여러 유형의 이력을 한 번에 조회할 수 있습니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

memberHistoryRequeststringRequired

MemberHistoryRequest

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberHistoryList

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberHistoryList?memberHistoryRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "mbrNo": 100000151,
      "mbrNm": "홍길동",
      "chgTgtTypCd": 11,
      "chgTgtTypNm": "주소",
      "chgCont": "서울 송파구 법원로9길 26",
      "sysRegId": 999999999,
      "sysRegDtm": "2023-07-26 18:38:07",
      "mbrInfoChgSeq": 1
    }
  ]
}

회원등급 이력 조회 - 목록

get

기능설명

• 회원등급 이력을 조회합니다.

---

상세설명

• 대상회원의 회원등급 변경 이력 목록을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

회원등급이력조회 Response

mbrNostringOptional

회원번호

Example: 100000300

mbrGradeCdstringOptional

회원등급코드(ME008)

Example: 20

mbrGradeNmstringOptional

회원등급명(ME008)

Example: VVIP

histStrDtmstringOptional

이력시작일시

Example: 2022-08-17 17:39:36

histEndDtmstringOptional

이력종료일시

Example: 2023-08-17 17:39:36

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberGradeHistoryByMemberNoData

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberGradeHistoryByMemberNoData?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "mbrNo": 100000300,
    "mbrGradeCd": 20,
    "mbrGradeNm": "VVIP",
    "histStrDtm": "2022-08-17 17:39:36",
    "histEndDtm": "2023-08-17 17:39:36"
  }
]

회원등급 이력 개수 조회

get

기능설명

• 회원등급의 이력 목록 총 개수를 초회 합니다.

---

상세설명

• 대상 회원의 회원등급 변경 이력의 전체 개수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

integer · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberGradeHistoryByMemberNoCount

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberGradeHistoryByMemberNoCount?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

배송지 조회(미마스킹)

get

기능설명

• 배송지 목록을 조회합니다.

---

상세설명

• 회원이 등록한 배송지 목록을 조회합니다.

• 관리자의 개인정보 열람 권한과 상관없이 회원의 개인정보가 출력됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

memberDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

회원 배송지 개인정보 미마스킹 조회 Response

mbrNostringOptional

회원번호

Example: 100001731

mbrDlvpSeqstringOptional

회원배송지순번

Example: 1

dlvpNmstringOptional

배송지명

Example: 회사

rcvmnNmstringOptional

수취인명

Example: 플래티어

baseDlvpYnstringOptional

기본배송지여부

Example: Y

nafrGbNmYnstringOptional

내국인/외국인여부

Example: Y

zipNoSeqinteger · int64Optional

우편번호순번

Example: 0

zipNostringOptional

우편번호

Example: 05836

zipAddrstringOptional

우편주소

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

dtlAddrstringOptional

상세주소

Example: 에이치비지니스파크 D동 6층 플래티어

emailAddrstringOptional

email주소

Example: [e-mail]

telNostringOptional

전화번호

Example: 02-123-1234

telRgnNostringOptional

전화지역번호

Example: 02

telTxnoNostringOptional

전화국번번호

Example: 123

telEndNostringOptional

전화끝번호

Example: 1234

cellNostringOptional

휴대폰번호

Example: 010-1234-1234

cellSctNostringOptional

휴대폰구분번호

Example: 010

cellTxnoNostringOptional

휴대폰국번번호

Example: 1234

cellEndNostringOptional

휴대폰끝번호

Example: 1234

deliMsgCdstringOptional

배송메시지코드(ME039)

Example: 10

deliMsgNmstringOptional

배송메시지코드명(ME039)

Example: 문 앞에 두고 가주세요.

deliMsgstringOptional

배송메시지

Example: 부재 시 연락주세요

comnFrdrCogoMethodCdstringOptional

공동현관출입방법코드(ME040)

Example: 10

comnFrdrCogoMethodNmstringOptional

공동현관출입방법코드명(ME040)

Example: 공통현관 출입번호

comnFrdrEtcMethodstringOptional

공동현관기타방법

Example: 경비실 호출 하세요

comnFrdrPwdstringOptional

공동현관비밀번호

Example: 12345

useYnstringOptional

사용여부

Example: Y

sysRegIdstringOptional

시스템등록자ID

Example: 999999999

sysRedDtmstringOptional

시스템등록일시

Example: 2023-08-17 17:39:36

sysModIdstringOptional

시스템수정자ID

Example: 999999999

sysModDtmstringOptional

시스템수정일시

Example: 2023-08-17 17:39:36

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberDeliveryNoMasking

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberDeliveryNoMasking?memberDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "mbrNo": 100001731,
  "mbrDlvpSeq": 1,
  "dlvpNm": "회사",
  "rcvmnNm": "플래티어",
  "baseDlvpYn": "Y",
  "nafrGbNmYn": "Y",
  "zipNoSeq": 0,
  "zipNo": "05836",
  "zipAddr": "서울 송파구 문정동 법원로 9길 26",
  "dtlAddr": "에이치비지니스파크 D동 6층 플래티어",
  "emailAddr": "[e-mail]",
  "telNo": "02-123-1234",
  "telRgnNo": "02",
  "telTxnoNo": 123,
  "telEndNo": 1234,
  "cellNo": "010-1234-1234",
  "cellSctNo": "010",
  "cellTxnoNo": 1234,
  "cellEndNo": 1234,
  "deliMsgCd": 10,
  "deliMsgNm": "문 앞에 두고 가주세요.",
  "deliMsg": "부재 시 연락주세요",
  "comnFrdrCogoMethodCd": 10,
  "comnFrdrCogoMethodNm": "공통현관 출입번호",
  "comnFrdrEtcMethod": "경비실 호출 하세요",
  "comnFrdrPwd": 12345,
  "useYn": "Y",
  "sysRegId": 999999999,
  "sysRedDtm": "2023-08-17 17:39:36",
  "sysModId": 999999999,
  "sysModDtm": "2023-08-17 17:39:36"
}

배송지 조회(마스킹)

get

기능설명

• 배송지 목록을 조회합니다.

---

상세설명

• 회원이 등록한 배송지 목록을 조회합니다.

• 관리자의 개인정보 열람 권한과 상관없이 회원의 모든 개인정보가 마스킹되어 출력됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberDeliveryMaskingList

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberDeliveryMaskingList?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "mbrNo": 100001731,
      "mbrDlvpSeq": 1,
      "dlvpNm": "회사",
      "rcvmnNm": "플래티어",
      "baseDlvpYn": "Y",
      "nafrGbNmYn": "Y",
      "zipNoSeq": 1,
      "zipNo": "05836",
      "zipAddr": "서울 송파구 문정동 법원로 9길 26",
      "dtlAddr": "에이치비지니스파크 D동 6층 플래티어",
      "emailAddr": "[e-mail]",
      "telNo": "02-123-1234",
      "telRgnNo": "02",
      "telTxnoNo": 123,
      "telEndNo": 1234,
      "cellNo": "010-1234-1234",
      "cellSctNo": "010",
      "cellTxnoNo": 1234,
      "cellEndNo": 1234,
      "deliMsgCd": 10,
      "deliMsgNm": "문 앞에 두고 가주세요.",
      "deliMsg": "부재 시 연락주세요",
      "comnFrdrCogoMethodCd": 10,
      "comnFrdrCogoMethodNm": "공통현관 출입번호",
      "comnFrdrEtcMethod": "경비실 호출 하세요",
      "comnFrdrPwd": 12345,
      "useYn": "Y",
      "sysRegId": 999999999,
      "sysRedDtm": "2023-08-17 17:39:36",
      "sysModId": 999999999,
      "sysModDtm": "2023-08-17 17:39:36"
    }
  ]
}

회원 배송지 조회 - 목록

get

기능설명

• 배송지 목록을 조회합니다.

---

상세설명

• 회원이 등록한 배송지 목록을 조회합니다.

• 관리자의 개인정보 열람 권한에 따라 개인정보가 마스킹되어 출력됩니다.

• 개인정보 마스킹 출력 조건

  • 관리자의 개인정보 열람 권한이 없는 경우

  • 관리자의 개인정보 열람 권한은 있으나, 해당 항목에 대한 권한이 없는 경우

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

회원 배송지 조회 Response

mbrNostringOptional

회원번호

Example: 100001731

mbrDlvpSeqstringOptional

회원배송지순번

Example: 1

dlvpNmstringOptional

배송지명

Example: 회사

rcvmnNmstringOptional

수취인명

Example: 플래티어

baseDlvpYnstringOptional

기본배송지여부

Example: Y

nafrGbNmYnstringOptional

내국인/외국인여부

Example: Y

zipNoSeqinteger · int64Optional

우편번호순번

zipNostringOptional

우편번호

Example: 05836

zipAddrstringOptional

우편주소

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

dtlAddrstringOptional

상세주소

Example: 에이치비지니스파크 D동 6층 플래티어

emailAddrstringOptional

email주소

Example: [e-mail]

telNostringOptional

전화번호

Example: 02-123-1234

telRgnNostringOptional

전화지역번호

Example: 02

telTxnoNostringOptional

전화국번번호

Example: 123

telEndNostringOptional

전화끝번호

Example: 1234

cellNostringOptional

휴대폰번호

Example: 010-1234-1234

cellSctNostringOptional

휴대폰구분번호

Example: 010

cellTxnoNostringOptional

휴대폰국번번호

Example: 1234

cellEndNostringOptional

휴대폰끝번호

Example: 1234

deliMsgCdstringOptional

배송메시지코드(ME039)

Example: 10

deliMsgNmstringOptional

배송메시지코드명(ME039)

Example: 문 앞에 두고 가주세요.

deliMsgstringOptional

배송메시지

Example: 부재 시 연락주세요

comnFrdrCogoMethodCdstringOptional

공동현관출입방법코드(ME040)

Example: 10

comnFrdrCogoMethodNmstringOptional

공동현관출입방법코드명(ME040)

Example: 공통현관 출입번호

comnFrdrEtcMethodstringOptional

공동현관기타방법

Example: 경비실 호출 하세요

comnFrdrPwdstringOptional

공동현관비밀번호

Example: 12345

useYnstringOptional

사용여부

Example: Y

sysRegIdstringOptional

시스템등록자ID

Example: 999999999

sysRedDtmstringOptional

시스템등록일시

Example: 2023-08-17 17:39:36

sysModIdstringOptional

시스템수정자ID

Example: 999999999

sysModDtmstringOptional

시스템수정일시

Example: 2023-08-17 17:39:36

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberDeliveryList

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberDeliveryList?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "mbrNo": 100001731,
    "mbrDlvpSeq": 1,
    "dlvpNm": "회사",
    "rcvmnNm": "플래티어",
    "baseDlvpYn": "Y",
    "nafrGbNmYn": "Y",
    "zipNoSeq": 1,
    "zipNo": "05836",
    "zipAddr": "서울 송파구 문정동 법원로 9길 26",
    "dtlAddr": "에이치비지니스파크 D동 6층 플래티어",
    "emailAddr": "[e-mail]",
    "telNo": "02-123-1234",
    "telRgnNo": "02",
    "telTxnoNo": 123,
    "telEndNo": 1234,
    "cellNo": "010-1234-1234",
    "cellSctNo": "010",
    "cellTxnoNo": 1234,
    "cellEndNo": 1234,
    "deliMsgCd": 10,
    "deliMsgNm": "문 앞에 두고 가주세요.",
    "deliMsg": "부재 시 연락주세요",
    "comnFrdrCogoMethodCd": 10,
    "comnFrdrCogoMethodNm": "공통현관 출입번호",
    "comnFrdrEtcMethod": "경비실 호출 하세요",
    "comnFrdrPwd": 12345,
    "useYn": "Y",
    "sysRegId": 999999999,
    "sysRedDtm": "2023-08-17 17:39:36",
    "sysModId": 999999999,
    "sysModDtm": "2023-08-17 17:39:36"
  }
]

회원 배송지 개수 조회

get

기능설명

• 배송지의 목록 개수를 조회합니다.

---

상세설명

• 회원이 등록한 배송지의 목록 전체 개수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

integer · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberDeliveryListCount

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberDeliveryListCount?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

회원연락처 변경 이력 목록 조회

get

기능설명

• 회원 연락처 정보 이력 목록을 조회합니다.

---

상세설명

• 회원의 개인정보 변경 이력 중 연락처 정보 변경 이력을 조회합니다.

• 관리자의 개인정보 열람 권한에 따라 개인정보가 마스킹되어 출력됩니다.

• 개인정보 마스킹 출력 조건

  • 관리자의 개인정보 열람 권한이 없는 경우

  • 관리자의 개인정보 열람 권한은 있으나, 해당 항목에 대한 권한이 없는 경우

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

회원 연락처 정보 이력 조회 Response

chgTgtTypNmstringOptional

변경대상유형코드명(ME004)

Example: 휴대폰번호

chgTgtTypCdstringOptional

변경대상유형코드(ME004)

Example: 12

chgCellNostringOptional

휴대폰번호 변경 내용

Example: 01012341234

chgTelNostringOptional

전화번호 변경 내용

Example: 021231234

chgEmailstringOptional

이메일 변경 내용

Example: [e-mail]

sysRegIdstringOptional

등록자 > 수정자

Example: 999999999

sysRegDtmstringOptional

등록일시 > 수정일시

Example: 2023-07-26 18:38:07

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberContactHistoryByMemberNoData

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberContactHistoryByMemberNoData?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "chgTgtTypNm": "휴대폰번호",
    "chgTgtTypCd": 12,
    "chgCellNo": "01012341234",
    "chgTelNo": "021231234",
    "chgEmail": "[e-mail]",
    "sysRegId": 999999999,
    "sysRegDtm": "2023-07-26 18:38:07"
  }
]

회원연락처 변경 이력 개수 조회

get

기능설명

• 회원연락처 변경 이력 총 개수를 조회합니다.

---

상세설명

• 회원의 개인정보 변경 이력 중 연락처 정보 변경 이력에 대한 전체 개수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

integer · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberContactHistoryByMemberNoCount

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberContactHistoryByMemberNoCount?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

사업자 담당자 정보 변경 이력 목록 조회

get

기능설명

• 사업자 담당자 정보 변경 이력 목록을 조회합니다.

---

상세설명

• 사업자 담당자 정보 변경 이력 목록을 조회합니다.

• 관리자의 개인정보 열람 권한에 따라 개인정보가 마스킹되어 출력됩니다.

• 개인정보 마스킹 출력 조건

  • 관리자의 개인정보 열람 권한이 없는 경우

  • 관리자의 개인정보 열람 권한은 있으나, 해당 항목에 대한 권한이 없는 경우

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberAempHistory

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberAempHistory?memberHistoryRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "aempNm": "홍길동",
      "aempCellNo": "01012345678",
      "sysRegId": 999999999,
      "sysRegDtm": "2023-07-26 18:38:07"
    }
  ]
}

주소변경 이력 목록 조회

get

기능설명

• 주소 변경 이력 목록을 조회합니다.

---

상세설명

• 회원의 개인정보 변경 이력 중 주소 변경이력 목록을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

주소 변경 이력 조회 Response

chgTgtTypNmstringOptional

변경대상유형코드명(ME004)

Example: 주소

chgContstringOptional

변경내용

Example: 서울 송파구 법원로9길 26에이치비지니스파크 D동 6층

sysRegIdstringOptional

등록자 > 수정자

Example: 999999999

sysRegDtmstringOptional

등록일시 > 수정일시

Example: 2023-07-26 18:38:07

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberAddressHistoryByMemberNoData

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberAddressHistoryByMemberNoData?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "chgTgtTypNm": "주소",
    "chgCont": "서울 송파구 법원로9길 26에이치비지니스파크 D동 6층",
    "sysRegId": 999999999,
    "sysRegDtm": "2023-07-26 18:38:07"
  }
]

주소변경 이력 개수 조회

get

기능설명

• 주소 변경 이력 총 개수를 조회합니다.

---

상세설명

• 회원의 개인정보 변경 이력 중 주소 변경이력 목록의 전체 개수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

integer · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMemberAddressHistoryByMemberNoCount

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMemberAddressHistoryByMemberNoCount?mbrDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

마일리지 조회

get

기능설명

• 회원의 마일리지를 조회합니다.

---

상세설명

• 회원의 사용 가능한 마일리지를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

MemberDetailRequeststringRequired

MemberDetailRequest

Responses

200

성공

*/*

integer · int64Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMbrMilg

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMbrMilg?request=[object+Object]&MemberDetailRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

쿠폰 개수 조회

get

기능설명

• 회원의 쿠폰 개수를 조회합니다.

---

상세설명

• 현재 회원이 사용할 수 있는 유효한 쿠폰 개수를 조회합니다,

• 무료배송쿠폰건수, 일반쿠폰건수, 보상쿠폰건수가 조회됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrNostringRequired

회원번호

Responses

200

성공

*/*

쿠폰 개수 조회 Response

freeCntstringOptional

무료배송쿠폰건수

Example: 1

gnrCntstringOptional

일반쿠폰건수

Example: 1

cpstCntstringOptional

보상쿠폰건수

Example: 1

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getMbrCpnCntList

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getMbrCpnCntList?mbrNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "freeCnt": 1,
  "gnrCnt": 1,
  "cpstCnt": 1
}

고객센터 1:1 문의 목록 조회

get

기능설명

• 회원의 고객센터 1:1 문의 목록을 조회합니다.

---

상세설명

• 회원이 진행한 고객선터 1:1 문의 목록을 조회합니다.

• 회원이 진행한 고객선터 1:1 문의 목록 건수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

CustomerCenterRequeststringRequired

CustomerCenterRequest

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getCustomerCenter

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getCustomerCenter?request=[object+Object]&CustomerCenterRequest=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "ccnNo": 11111,
      "mbrNo": 1000001,
      "reqCtg": "1:1문의",
      "ccnPrgsStatCd": 20,
      "ccnPrgsStatNm": "처리중",
      "accpDtm": "2023-05-10 12:30:00",
      "ansDtm": "2023-05-10 12:30:00",
      "accpTitle": "문의",
      "hierarchyCustInqTypNm": "배송>배송확인"
    }
  ]
}