이벤트 참여내역

이벤트 배송지 저장

post

기능 설명

• 이벤트 DB 배송지 변경 기본 API입니다.

---

상세 설명

• 회원번호와 응모한 이벤트 번호를 받아 응모자 테이블의 배송지 정보 변경을합니다.

• 해당 회원의 배송지 수정(EVENT DB)

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

이벤트 응모자 정보

trgmnSeqstringOptional

대상자순번

evtTrgmnGbCdstringOptional

이벤트대상자구분코드(EV012)

mbrNostringOptional

회원번호

sbscAplyDtmstring · date-timeOptional

응모신청일시

wtpsSltDtmstring · date-timeOptional

대기자선정일시

winDtmstringOptional

당첨일시

winRnkinteger · int32Optional

당첨순위

smsSndCntinteger · int32Optional

SMS발송수

winCnclDtmstring · date-timeOptional

당첨취소일시

winCnclCausContstringOptional

당첨취소사유내용

evtNostringOptional

이벤트번호

waitRnkinteger · int32Optional

대기순위

intxinteger · int32Optional

소득세

citxinteger · int32Optional

주민세

myCertiDtmstring · date-timeOptional

본인인증일시

ordSumAmtinteger · int32Optional

주문합계금액

cfmOrdAmtinteger · int32Optional

확정주문금액

evtSbscPathCdstringOptional

이벤트응모경로코드

tubaBankCdstringOptional

제세공과금은행코드

tubaDepositorNmstringOptional

제세공과금예금주명

tubaVirActnNostringOptional

제세공과금가상계좌번호

tubaDptAmtinteger · int32Optional

제세공과금입금액

tubaDptDtmstring · date-timeOptional

제세공과금입금일시

deliHdcCdstringOptional

배송택배사코드(LO005)

deliInvNostringOptional

배송운송장번호

mailSndCntinteger · int32Optional

메일발송수

bbcNostringOptional

게시글번호

lotCondSeqstringOptional

추첨조건순번

etcGftDlvpNostringOptional

기타사은품배송지번호

etcGftStatCdstringOptional

기타사은품상태코드

paysYnstringOptional

지급여부

paysDtmstring · date-timeOptional

지급일시

trnsYnstringOptional

배송전송여부

rcvmnNmstringOptional

수취인명

zipNostringOptional

우편번호

zipAddrstringOptional

우편주소

dtlAddrstringOptional

상세주소

cellSctNostringOptional

휴대폰구분번호

cellTxnoNostringOptional

휴대폰국번번호

cellEndNostringOptional

휴대폰끝번호

deliMsgstringOptional

배송메시지

comnFrdrEtcMethodstringOptional

공동현관기타방법

comnFrdrPwdstringOptional

공동현관비밀번호

comnFrdrCogoMethodCdstringOptional

공동현관출입방법코드

evtFvrSeqstringOptional

이벤트 혜택순번

Responses

200

OK

*/*

stringOptional

post

/v1/marketing/evtDlvChange

HTTPcURLJavaScriptPython

POST /api/event/v1/marketing/evtDlvChange HTTP/1.1
Host: localhost:8095/
Content-Type: application/json
Accept: */*
Content-Length: 941

{
  "trgmnSeq": "text",
  "evtTrgmnGbCd": "text",
  "mbrNo": "text",
  "sbscAplyDtm": "2026-02-27T18:07:54.467Z",
  "wtpsSltDtm": "2026-02-27T18:07:54.467Z",
  "winDtm": "text",
  "winRnk": 1,
  "smsSndCnt": 1,
  "winCnclDtm": "2026-02-27T18:07:54.467Z",
  "winCnclCausCont": "text",
  "evtNo": "text",
  "waitRnk": 1,
  "intx": 1,
  "citx": 1,
  "myCertiDtm": "2026-02-27T18:07:54.467Z",
  "ordSumAmt": 1,
  "cfmOrdAmt": 1,
  "evtSbscPathCd": "text",
  "tubaBankCd": "text",
  "tubaDepositorNm": "text",
  "tubaVirActnNo": "text",
  "tubaDptAmt": 1,
  "tubaDptDtm": "2026-02-27T18:07:54.467Z",
  "deliHdcCd": "text",
  "deliInvNo": "text",
  "mailSndCnt": 1,
  "bbcNo": "text",
  "lotCondSeq": "text",
  "etcGftDlvpNo": "text",
  "etcGftStatCd": "text",
  "paysYn": "text",
  "paysDtm": "2026-02-27T18:07:54.467Z",
  "trnsYn": "text",
  "rcvmnNm": "text",
  "zipNo": "text",
  "zipAddr": "text",
  "dtlAddr": "text",
  "cellSctNo": "text",
  "cellTxnoNo": "text",
  "cellEndNo": "text",
  "deliMsg": "text",
  "comnFrdrEtcMethod": "text",
  "comnFrdrPwd": "text",
  "comnFrdrCogoMethodCd": "text",
  "evtFvrSeq": "text"
}

200

OK

text

이벤트 구매 사은 응모 내역 조회

get

기능 설명

• 이벤트 사은품 응모 내역 조회 기본 API입니다.

---

상세 설명

• 로그인 필수입니다.

• 구매 사은 이벤트 응모 내역만 노출합니다.

• 진행상태, 기간(1주, 1개월, 3개월) 조건 조회 가능합니다.

수정 번호

• Release v2.00_240425: 이벤트 목록 조회 조건에 사이트번호 추가

Query parameters

siteNostringOptional

string

Example: 1

pageIdxstringRequired

string

Example: 1

rowsPerPagestringRequired

string

Example: 10

periodGbstringRequired

string

Example: 0

filteringGbstringOptional

string

Example: 2

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

사은품 응모 내역 조회 성공

*/*

이벤트 참여목록 Response

allPageCntinteger · int32Optional

전체페이지갯수

Example: 10

curPageNointeger · int32Optional

현재페이지번호

Example: 1

purEvtCntinteger · int32Optional

자동응모갯수

Example: 3

900

사은품 응모 내역 조회 실패

*/*

get

/v1/marketing/getPurFreeEventList

HTTPcURLJavaScriptPython

GET /api/event/v1/marketing/getPurFreeEventList?pageIdx=text&rowsPerPage=text&periodGb=text HTTP/1.1
Host: localhost:8095/
Accept: */*

{
  "allPageCnt": 10,
  "curPageNo": 1,
  "purEvtCnt": 3,
  "evtTrgmnInfo": [
    {
      "evtNo": 12345,
      "evtNm": "이벤트명 Sample!",
      "evtStrDtm": "2026-02-27",
      "evtEndDtm": "2026-02-27T18:07:54.467Z",
      "evtPrgsStatCd": "01",
      "evtPrgsStatNm": "임시등록",
      "orgEvtPrgsStatCd": "01",
      "evtUrlAddr": "/url",
      "evtBnrPathNm": "/url",
      "evtBnrFileNm": "이벤트배너명.jpeg",
      "evtBnrAltCont": "이벤트배너이미지 대체텍스트",
      "pcEvtBnrPathNm": "/url",
      "pcEvtBnrFileNm": "PC이벤트배너명.png",
      "pcEvtBnrAltCont": "PC용이벤트배너이미지 대체텍스트",
      "evtTrgmnGbCd": "01",
      "winDtm": "2023-08-21",
      "winRnk": 1,
      "evtFvrTypCd": 10,
      "evtGoodsNm": "상품권 50000원권",
      "payMilg": 500,
      "pmgdSndDt": "2023-08-23",
      "payDt": "2023-08-25",
      "zipNo": "05837",
      "zipAddr": "서울 송파구 법원로9길 26",
      "dtlAddr": "비즈니스파크",
      "cellSctNo": "010",
      "cellTxnoNo": 1234,
      "cellEndNo": 5678,
      "rcvmnNm": "플래티어",
      "etcGftStatCd": 10,
      "etcGftStatNm": 10,
      "purAmtEvtPromoYn": "N",
      "buyAmt": 50000,
      "purAmt": 30000,
      "evtLgrpCd": 10,
      "evtMgrpCd": 13,
      "goodsImgPath": "/url",
      "evetTermDesc": "행사기간설명 Sample",
      "evetCondDesc": "행사조건설명 Sample",
      "etcDesc1": "기타설명1 Sample",
      "etcDesc2": "기타설명2 Sample",
      "etcDesc3": "기타설명3 Sample",
      "etcDesc4": "기타설명4 Sample",
      "etcDesc5": "기타설명5 Sample",
      "paysTermDesc": "지급기간설명 Sample",
      "paysYn": "N",
      "paysDtm": "2023-08-22",
      "winCnclDtm": "2023-08-23",
      "trgmnSeq": 1,
      "pmgdSndDtCal": 5,
      "etcGftDlvpNo": 123,
      "trnsYn": "N",
      "hdcCd": 22,
      "invNo": 10000293,
      "sbscAplyStrDtm": "2026-02-27T18:07:54.467Z",
      "sbscAplyEndDtm": "2026-02-27T18:07:54.467Z",
      "buyStrDtm": "2026-02-27T18:07:54.467Z",
      "buyEndDtm": "2026-02-27T18:07:54.467Z",
      "sbscPsbMinOrdAmt": 1000,
      "orderList": [
        {
          "ordNo": "20230809O007943",
          "ordDtm": "2026-02-27T18:07:54.467Z",
          "ordAmt": 510000
        }
      ]
    }
  ]
}

이벤트 참여내역 조회

get

기능 설명

• 이벤트 참여내역 조회 기본 API입니다.

---

상세 설명

• 로그인 필수입니다.

• 구매 사은 이벤트를 제외한 이벤트 참여내역 조회

• 진행상태, 기간(1주, 1개월, 3개월) 조건 조회 가능

---

수정 내역

• Release v2.00_240401 : 구매 사은 이벤트 내역 포함

• Release v2.00_240425: 목록 조회 조건에 사이트번호 추가

Query parameters

siteNostringOptional

string

Example: 1

pageIdxstringRequired

string

Example: 1

rowsPerPagestringRequired

string

Example: 10

periodGbstringRequired

string

Example: 0

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

이벤트 참여내역 조회 성공

*/*

이벤트 참여목록 Response

allPageCntinteger · int32Optional

전체페이지갯수

Example: 10

curPageNointeger · int32Optional

현재페이지번호

Example: 1

purEvtCntinteger · int32Optional

자동응모갯수

Example: 3

900

이벤트 참여내역 조회 실패

*/*

get

/v1/marketing/getMyEventEntryList

HTTPcURLJavaScriptPython

GET /api/event/v1/marketing/getMyEventEntryList?pageIdx=text&rowsPerPage=text&periodGb=text HTTP/1.1
Host: localhost:8095/
Accept: */*

{
  "allPageCnt": 10,
  "curPageNo": 1,
  "purEvtCnt": 3,
  "evtTrgmnInfo": [
    {
      "evtNo": 12345,
      "evtNm": "이벤트명 Sample!",
      "evtStrDtm": "2026-02-27",
      "evtEndDtm": "2026-02-27T18:07:54.467Z",
      "evtPrgsStatCd": "01",
      "evtPrgsStatNm": "임시등록",
      "orgEvtPrgsStatCd": "01",
      "evtUrlAddr": "/url",
      "evtBnrPathNm": "/url",
      "evtBnrFileNm": "이벤트배너명.jpeg",
      "evtBnrAltCont": "이벤트배너이미지 대체텍스트",
      "pcEvtBnrPathNm": "/url",
      "pcEvtBnrFileNm": "PC이벤트배너명.png",
      "pcEvtBnrAltCont": "PC용이벤트배너이미지 대체텍스트",
      "evtTrgmnGbCd": "01",
      "winDtm": "2023-08-21",
      "winRnk": 1,
      "evtFvrTypCd": 10,
      "evtGoodsNm": "상품권 50000원권",
      "payMilg": 500,
      "pmgdSndDt": "2023-08-23",
      "payDt": "2023-08-25",
      "zipNo": "05837",
      "zipAddr": "서울 송파구 법원로9길 26",
      "dtlAddr": "비즈니스파크",
      "cellSctNo": "010",
      "cellTxnoNo": 1234,
      "cellEndNo": 5678,
      "rcvmnNm": "플래티어",
      "etcGftStatCd": 10,
      "etcGftStatNm": 10,
      "purAmtEvtPromoYn": "N",
      "buyAmt": 50000,
      "purAmt": 30000,
      "evtLgrpCd": 10,
      "evtMgrpCd": 13,
      "goodsImgPath": "/url",
      "evetTermDesc": "행사기간설명 Sample",
      "evetCondDesc": "행사조건설명 Sample",
      "etcDesc1": "기타설명1 Sample",
      "etcDesc2": "기타설명2 Sample",
      "etcDesc3": "기타설명3 Sample",
      "etcDesc4": "기타설명4 Sample",
      "etcDesc5": "기타설명5 Sample",
      "paysTermDesc": "지급기간설명 Sample",
      "paysYn": "N",
      "paysDtm": "2023-08-22",
      "winCnclDtm": "2023-08-23",
      "trgmnSeq": 1,
      "pmgdSndDtCal": 5,
      "etcGftDlvpNo": 123,
      "trnsYn": "N",
      "hdcCd": 22,
      "invNo": 10000293,
      "sbscAplyStrDtm": "2026-02-27T18:07:54.467Z",
      "sbscAplyEndDtm": "2026-02-27T18:07:54.467Z",
      "buyStrDtm": "2026-02-27T18:07:54.467Z",
      "buyEndDtm": "2026-02-27T18:07:54.467Z",
      "sbscPsbMinOrdAmt": 1000,
      "orderList": [
        {
          "ordNo": "20230809O007943",
          "ordDtm": "2026-02-27T18:07:54.467Z",
          "ordAmt": 510000
        }
      ]
    }
  ]
}