Event Common

Process Member Default Delivery Address Merge

post

Function Description

This API merges the member's default delivery address.

Detailed Description

Synchronizes the member's delivery address information in the order DB with the member's delivery address information in the event DB.
Requires all parameters for the member delivery address information columns.
Called from API-BO, API-MEMBER, and event BATCH.

Header parameters

AuthorizationanyOptional

Access Token

Body

Member Delivery Information Request

mbrNostringOptional

Member No.

Responses

200

Member default delivery address merged successfully

*/*

stringOptional

900

Failed to merge member default delivery address

*/*

post/v1/common/mergeMbrDlvp

POST /api/event/v1/common/mergeMbrDlvp HTTP/1.1
Host: api-event.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 599

{
  "mbrNo": "text",
  "etMbrDlvpInfo": [
    {
      "mbrNo": 10001234,
      "mbrDlvpSeq": 1,
      "dlvpGbCd": 10,
      "dlvpNm": "배송지명",
      "rcvmnNm": "홍길동",
      "baseDlvpYn": "Y",
      "zipNoSeq": 1,
      "zipNo": 5837,
      "zipAddr": "서울 송파구 법원로9길",
      "dtlAddr": "서울 송파구 법원로9길 에이치비지니스파크 D동 6층23",
      "cellSctNo": "010",
      "cellTxnoNo": 1234,
      "cellEndNo": 5678,
      "telRgnNo": "02",
      "telTxnoNo": 123,
      "telEndNo": 4567,
      "deliMsgCd": 10,
      "deliMsg": "문 앞에 두고 가주세요.",
      "comnFrdrCogoMethodCd": 10,
      "comnFrdrEtcMethod": "자유출입가능",
      "comnFrdrPwd": 1234,
      "useYn": "Y",
      "userSortSeq": 1,
      "emailAddr": "abc@gmail.com"
    }
  ]
}

text

Process Member Basic Information Merge

post

Function Description

This API synchronizes member information.

Detailed Description

Synchronizes the member information in the order DB with the member information in the event DB.
Requires all parameters for the member information columns.
Called from api-member and event batch.

Header parameters

AuthorizationanyOptional

Access Token

Body

Member Information Request

Responses

200

Member basic information merged successfully

*/*

stringOptional

900

Failed to merge member basic information

*/*

post/v1/common/mergeMbrBase

POST /api/event/v1/common/mergeMbrBase HTTP/1.1
Host: api-event.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 1592

{
  "etMbrBase": {
    "siteNo": 1,
    "sysRegDtm": "2026-01-01T00:00:00.000Z",
    "sysRegId": "text",
    "sysModDtm": "2026-01-01T00:00:00.000Z",
    "sysModId": "text",
    "mbrNo": 10001234,
    "mbrGbCd": 10,
    "mbrMgrCd": 10,
    "mbrStatCd": 10,
    "lgcMbrNo": "text",
    "lgcMbrYn": "text",
    "lgcWdraTgtYn": "text",
    "cmbnMbspMbrNo": "text",
    "mbrNm": "홍길동",
    "loginId": "guest01",
    "pwd": 1234,
    "mbrGradeCd": 10,
    "solarYn": "N",
    "brth": 19950101,
    "sexGbCd": "M",
    "nafrGbCd": 10,
    "joinGbCd": 10,
    "telRgnNo": "02",
    "telTxnoNo": 123,
    "telEndNo": 4567,
    "cellSctNo": "010",
    "cellTxnoNo": 1234,
    "cellEndNo": 5678,
    "frgnTelNo": "text",
    "emailAddr": "abc@gmail.com",
    "zipNoSeq": 1,
    "zipNo": 5837,
    "zipAddr": "서울 송파구 법원로9길",
    "dtlAddr": "에이치비지니스파크 D동 6층23",
    "stafYn": "N",
    "empNo": "text",
    "comGbCd": 10,
    "adlCertiYn": "Y",
    "adlCertiDtm": "2026-01-01T00:00:00.000Z",
    "mbrJoinDtm": "2026-01-01T00:00:00.000Z",
    "frstOrdDtm": "2026-01-01T00:00:00.000Z",
    "lstOrdDtm": "2026-01-01T00:00:00.000Z",
    "frstLoginDtm": "2026-01-01T00:00:00.000Z",
    "lstLoginDtm": "2026-01-01T00:00:00.000Z",
    "pgGbCd": "text",
    "rcntPayWayCd": 11,
    "stafMgrNo": 10,
    "stafRegDt": "2023-08-01",
    "stafRvcDt": "2023-08-31",
    "cmbnMbspLoginId": "text",
    "payNo": "text",
    "smpctAcctIntrlckGbCd": 10,
    "bmanRegNo": 1234567890,
    "bmanRegDt": 20230801,
    "rpstmnNm": "홍길동",
    "repTelSctNo": "02",
    "repTelTxnoNo": 123,
    "repTelEndNo": 4567,
    "joinSgtStatCd": 10,
    "aprvRtrnCaus": "사업자등록증 첨부 안됨",
    "aprvRtrnDtm": "2023-08-01 12:00:00",
    "mbrJoinReqDtm": "2023-08-01 12:00:00",
    "bmanNm": "홍길동 사업체",
    "sysProcId": "admin",
    "bplcZipNo": 5837,
    "bplcZipAddr": "서울 송파구 법원로9길",
    "bplcDtlAddr": "에이치비지니스파크 D동 6층23"
  }
}

text

Retrieve My Participated Event List (BO)

get

Function Description

This is the basic API for retrieving my participated event list (BO).

Detailed Description

Login is required.
Ongoing participated events + ended participated events (up to 7 days after entry) + ended gift events (up to 7 days after entry)
Member number (mbrNo) is required.

Query parameters

pageIdxstringRequired

string

Example: 1

rowsPerPagestringRequired

string

Example: 10

mbrNostringRequired

string

Example: 100000290

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

My participated event list retrieved successfully (BO)

*/*

evtNostringOptional

Event No.

Example: 12345

evtNmstringOptional

Event Name

Example: 이벤트명 Sample

aplyDtstringOptional

Entry Date

Example: 2023-08-18

strDtstringOptional

Event Start Date

Example: 2023-08-01

endDtstringOptional

Event End Date

Example: 2023-08-31

evtPrgsStatCdstringOptional

Management Status (EV005)

Example: 01

evtPrgsStatNmstringOptional

In Progress Status Name

Example: 임시등록

winDtstringOptional

Winning Date

Example: 2023-08-21

winYnstringOptional

Winning Status

Example: Y

900

Failed to retrieve my participated event list (BO)

*/*

get/v1/marketing/getParticipationEvent

GET /api/event/v1/marketing/getParticipationEvent?pageIdx=text&rowsPerPage=text&mbrNo=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*

{
  "evtNo": 12345,
  "evtNm": "이벤트명 Sample",
  "aplyDt": "2023-08-18",
  "strDt": "2023-08-01",
  "endDt": "2023-08-31",
  "evtPrgsStatCd": "01",
  "evtPrgsStatNm": "임시등록",
  "winDt": "2023-08-21",
  "winYn": "Y"
}

Retrieve My Participated Event Count

get

Function Description

This is the basic API for retrieving the count of my participated events (BO).

Detailed Description

Login is required.
Ongoing participated events + ended participated events (up to 7 days after entry) + ended gift events (up to 7 days after entry)
Member number (mbrNo) is required.

Query parameters

pageIdxstringRequired

string

Example: 1

rowsPerPagestringRequired

string

Example: 10

mbrNostringRequired

string

Example: 100000290

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

My participated event count retrieved successfully (BO)

*/*

evtNostringOptional

Event No.

Example: 12345

evtNmstringOptional

Event Name

Example: 이벤트명 Sample

aplyDtstringOptional

Entry Date

Example: 2023-08-18

strDtstringOptional

Event Start Date

Example: 2023-08-01

endDtstringOptional

Event End Date

Example: 2023-08-31

evtPrgsStatCdstringOptional

Management Status (EV005)

Example: 01

evtPrgsStatNmstringOptional

In Progress Status Name

Example: 임시등록

winDtstringOptional

Winning Date

Example: 2023-08-21

winYnstringOptional

Winning Status

Example: Y

900

Failed to retrieve my participated event count (BO)

*/*

get/v1/marketing/getParticipationEventCount

GET /api/event/v1/marketing/getParticipationEventCount?pageIdx=text&rowsPerPage=text&mbrNo=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*

{
  "evtNo": 12345,
  "evtNm": "이벤트명 Sample",
  "aplyDt": "2023-08-18",
  "strDt": "2023-08-01",
  "endDt": "2023-08-31",
  "evtPrgsStatCd": "01",
  "evtPrgsStatNm": "임시등록",
  "winDt": "2023-08-21",
  "winYn": "Y"
}

Retrieve Event Member Default Delivery Address

get

Function Description

This is the basic API for retrieving the member's default delivery address from the event DB.

Detailed Description

Retrieves the default delivery address using the member number as a parameter.
Retrieves the member's default delivery address (EVENT DB)
Member number (mbrNo) is required.

Query parameters

mbrNostringRequired

string

Example: 100000290

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

Member default delivery address retrieved successfully

*/*

Member Delivery Information

mbrNostringOptional

Member No.

Example: 10001234

mbrDlvpSeqstringOptional

Member Delivery Address Sequence No.

Example: 1

dlvpGbCdstringOptional

Delivery Address Type Code (ME044)

Example: 10

dlvpNmstringOptional

Delivery Address Name

Example: 배송지명

rcvmnNmstringOptional

Recipient Name

Example: 홍길동

baseDlvpYnstringOptional

Default Delivery Address Status

Example: Y

zipNoSeqinteger · int32Optional

Postal Code Sequence No.

Example: 1

zipNostringOptional

Postal Code

Example: 5837

zipAddrstringOptional

Postal Address

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

dtlAddrstringOptional

Detailed Address

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

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1234

cellEndNostringOptional

Mobile Phone Last Digits

Example: 5678

telRgnNostringOptional

Phone Area Code

Example: 02

telTxnoNostringOptional

Phone Exchange Code

Example: 123

telEndNostringOptional

Phone Last Digits

Example: 4567

deliMsgCdstringOptional

Delivery Message Code (ME039)

Example: 10

deliMsgstringOptional

Delivery Message

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

comnFrdrCogoMethodCdstringOptional

Common Entrance Access Method Code (ME040)

Example: 10

comnFrdrEtcMethodstringOptional

Other Common Entrance Access Method

Example: 자유출입가능

comnFrdrPwdstringOptional

Common Entrance Password

Example: 1234

useYnstringOptional

Usage Status

Example: Y

userSortSeqinteger · int32Optional

User Sort Order

Example: 1

emailAddrstringOptional

Example: abc@gmail.com

900

Failed to retrieve member default delivery address

*/*

get/v1/marketing/getEtMbrDlvpInfo

GET /api/event/v1/marketing/getEtMbrDlvpInfo?mbrNo=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*

{
  "mbrNo": 10001234,
  "mbrDlvpSeq": 1,
  "dlvpGbCd": 10,
  "dlvpNm": "배송지명",
  "rcvmnNm": "홍길동",
  "baseDlvpYn": "Y",
  "zipNoSeq": 1,
  "zipNo": 5837,
  "zipAddr": "서울 송파구 법원로9길",
  "dtlAddr": "서울 송파구 법원로9길 에이치비지니스파크 D동 6층23",
  "cellSctNo": "010",
  "cellTxnoNo": 1234,
  "cellEndNo": 5678,
  "telRgnNo": "02",
  "telTxnoNo": 123,
  "telEndNo": 4567,
  "deliMsgCd": 10,
  "deliMsg": "문 앞에 두고 가주세요.",
  "comnFrdrCogoMethodCd": 10,
  "comnFrdrEtcMethod": "자유출입가능",
  "comnFrdrPwd": 1234,
  "useYn": "Y",
  "userSortSeq": 1,
  "emailAddr": "abc@gmail.com"
}

PreviousEvent Participation History

NextSeparate Storage

Last updated 1 month ago