For the complete documentation index, see llms.txt. This page is also available as Markdown.

이벤트 공통

회원 기본 배송지 병합 처리

post

기능 설명

  • 회원 기본 배송지 병합하는 API 입니다.


상세 설명

  • order DB 의 회원 배송지 정보를 event DB의 회원 배송지 정보와 동기화합니다.

  • 회원 배송지 정보 컬럼에 대한 모든 파라미터를 필요로합니다.

  • API-BO , API-MEMBER , event BATCH 에서 호출합니다.

Header parameters
AuthorizationanyOptional

Access Token

Body

회원 배송 정보 Request

mbrNostringOptional

회원번호

Responses
200

회원 기본 배송지 병합 성공

*/*
stringOptional
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: 602

{
  "mbrNo": "text",
  "etMbrDlvpInfo": [
    {
      "mbrNo": 10001234,
      "mbrDlvpSeq": 1,
      "dlvpGbCd": 10,
      "dlvpNm": "배송지명",
      "rcvmnNm": "홍길동",
      "baseDlvpYn": "Y",
      "zipNoSeq": 1,
      "zipNo": "05837",
      "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

회원 기본 정보 병합 처리

post

기능 설명

  • 회원 정보를 동기화 처리하는 API 입니다.


상세 설명

  • order DB 의 회원정보를 event DB의 회원정보와 동기화합니다.

  • 회원정보 컬럼에 대한 모든 파라미터를 필요로합니다.

  • api-member , event batch 에서 호출합니다.

Header parameters
AuthorizationanyOptional

Access Token

Body

회원 정보 Request

Responses
200

회원 기본 정보 병합 성공

*/*
stringOptional
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: 1598

{
  "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": "05837",
    "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": "05837",
    "bplcZipAddr": "서울 송파구 법원로9길",
    "bplcDtlAddr": "에이치비지니스파크 D동 6층23"
  }
}
text

나의 참여 이벤트 목록 조회 (BO)

get

기능 설명

  • 나의 참여 이벤트 목록 조회(BO) 기본 API입니다.


상세 설명

  • 로그인 필수입니다.

  • 진행 중인 참여 이벤트 + 종료된 참여 이벤트(응모 이후 7일까지) + 종료된 사은 이벤트(응모 이후 7일까지)

  • **회원번호(mbrNo)**는 필수값입니다.

Query parameters
pageIdxstringRequired

string

Example: 1
rowsPerPagestringRequired

string

Example: 10
mbrNostringRequired

string

Example: 100000290
Header parameters
AuthorizationanyOptional

Access Token

Responses
200

나의 참여 이벤트 목록 조회 성공(BO)

*/*
evtNostringOptional

이벤트 번호

Example: 12345
evtNmstringOptional

이벤트 명

Example: 이벤트명 Sample
aplyDtstringOptional

응모일자

Example: 2023-08-18
strDtstringOptional

이벤트 시작일

Example: 2023-08-01
endDtstringOptional

이벤트 종료일

Example: 2023-08-31
evtPrgsStatCdstringOptional

관리상태(EV005)

Example: 01
evtPrgsStatNmstringOptional

진행중 상태 명

Example: 임시등록
winDtstringOptional

당첨일자

Example: 2023-08-21
winYnstringOptional

당첨여부

Example: Y
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"
}

나의 참여 이벤트 건수 조회

get

기능 설명

  • 나의 참여 이벤트 목록 수 조회(BO) 기본 API입니다.


상세 설명

  • 로그인 필수입니다.

  • 진행 중인 참여 이벤트 + 종료된 참여 이벤트(응모 이후 7일까지) + 종료된 사은 이벤트(응모 이후 7일까지)

  • **회원번호(mbrNo)**는 필수값입니다.

Query parameters
pageIdxstringRequired

string

Example: 1
rowsPerPagestringRequired

string

Example: 10
mbrNostringRequired

string

Example: 100000290
Header parameters
AuthorizationanyOptional

Access Token

Responses
200

나의 참여 이벤트 목록 수 조회 성공(BO)

*/*
evtNostringOptional

이벤트 번호

Example: 12345
evtNmstringOptional

이벤트 명

Example: 이벤트명 Sample
aplyDtstringOptional

응모일자

Example: 2023-08-18
strDtstringOptional

이벤트 시작일

Example: 2023-08-01
endDtstringOptional

이벤트 종료일

Example: 2023-08-31
evtPrgsStatCdstringOptional

관리상태(EV005)

Example: 01
evtPrgsStatNmstringOptional

진행중 상태 명

Example: 임시등록
winDtstringOptional

당첨일자

Example: 2023-08-21
winYnstringOptional

당첨여부

Example: Y
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"
}

이벤트 회원 기본 배송지 조회

get

기능 설명

  • 이벤트 DB 회원 기본 배송지 조회 기본 API입니다.


상세 설명

  • 회원 번호를 파라미터로 받아 기본배송지 조회합니다.

  • 해당 회원의 기본배송지 조회(EVENT DB)

  • **회원번호(mbrNo)**는 필수값입니다.

Query parameters
mbrNostringRequired

string

Example: 100000290
Header parameters
AuthorizationanyOptional

Access Token

Responses
200

회원 기본 배송지 조회 성공

*/*

회원 배송 정보

mbrNostringOptional

회원번호

Example: 10001234
mbrDlvpSeqstringOptional

회원배송지순번

Example: 1
dlvpGbCdstringOptional

배송지구분코드(ME044)

Example: 10
dlvpNmstringOptional

배송지명

Example: 배송지명
rcvmnNmstringOptional

수취인명

Example: 홍길동
baseDlvpYnstringOptional

기본배송지여부

Example: Y
zipNoSeqinteger · int32Optional

우편번호순번

Example: 1
zipNostringOptional

우편번호

Example: 05837
zipAddrstringOptional

우편주소

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

상세주소

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

휴대폰구분번호

Example: 010
cellTxnoNostringOptional

휴대폰국번번호

Example: 1234
cellEndNostringOptional

휴대폰끝번호

Example: 5678
telRgnNostringOptional

전화지역번호

Example: 02
telTxnoNostringOptional

전화국번번호

Example: 123
telEndNostringOptional

전화끝번호

Example: 4567
deliMsgCdstringOptional

배송메시지코드(ME039)

Example: 10
deliMsgstringOptional

배송메시지

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

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

Example: 10
comnFrdrEtcMethodstringOptional

공동현관기타방법

Example: 자유출입가능
comnFrdrPwdstringOptional

공동현관비밀번호

Example: 1234
useYnstringOptional

사용여부

Example: Y
userSortSeqinteger · int32Optional

사용자정렬순서

Example: 1
emailAddrstringOptional

이메일

Example: abc@gmail.com
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": "05837",
  "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"
}

마지막 업데이트