Event Lookup
Function Description
This is an API to retrieve event comments.
Detailed Description
Retrieves all comments or comments written by the user.
Revision History
Release v2.00_240401 : Initial development of event comment retrieval
Release v2.00_240425: Added site number to the event comment list search conditions
string
1string
12345string
Ystring
1string
10Access Token
Event comment retrieved successfully
Event Comment Information Response
Failed to retrieve event comment
GET /api/event/v1/marketing/getEventReplies?evtNo=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*
{
"totalCount": 1,
"replyList": [
{
"bbcNo": 412,
"evtNo": 12345,
"evtTmplRelNo": 16,
"evtBbGbCd": "text",
"bbcTitleNm": "게시글 제목",
"bbcCont": "게시글 내용입니다!.",
"wrtmnNm": "홍길동",
"wrtmnEmailAddr": "abc@gmail.com",
"mbrNo": 10001234,
"goodsNo": 10002111,
"dispSeq": 1,
"qryCnt": 101,
"recomCnt": 50,
"dispYn": "Y",
"pblYn": "N",
"delYn": "N",
"regDt": "2023-08-18",
"mbrNm": "홍길동",
"loginId": "guest01"
}
]
}Function Description
This is an API to retrieve the basic event list.
Detailed Description
Displays up to 10 events per page.
Events are displayed sorted according to the Latest/Deadline select box value.
One pinned event is always displayed at the top.
Survey events are not displayed in the list.
Code Summary
Latest/Deadline: 01: Latest, 02: Deadline
Revision History
Release v2.00_240425: Added site number to the event list search conditions
string
1string
1string
10string
01Access Token
Event list retrieved successfully
Event List Information Response
Total Page Count
Current Page No.
Failed to retrieve event list
GET /api/event/v1/marketing/getEventList?pageIdx=text&rowsPerPage=text&evtSortGb=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*
{
"allPageCnt": 1,
"curPageNo": 1,
"evtBrandList": [
{
"brandNo": "BR01",
"brandNm": "브랜드명01"
}
],
"evtBaseInfo": [
{
"evtNo": 12345,
"evtNm": "이벤트명 Sample",
"uprFixYn": "Y",
"evtObjCd": "01",
"evtLgrpCd": 10,
"evtMgrpCd": 13,
"evtExpNmCd": "01",
"sbscCntLmtCd": "01",
"evtPrgsStatCd": "01",
"evtStrDtm": "2026-01-01T00:00:00.000Z",
"evtEndDtm": "2026-01-01T00:00:00.000Z",
"buyStrDtm": "2026-01-01T00:00:00.000Z",
"buyEndDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
"evtUrlAddr": "/url",
"evtBnrPathNm": "/url",
"evtBnrFileNm": "이벤트배너명.jpeg",
"evtBnrAltCont": "이벤트배너이미지 대체텍스트",
"pcEvtBnrPathNm": "/url",
"pcEvtBnrFileNm": "PC이벤트배너명.png",
"pcEvtBnrAltCont": "PC이벤트배너이미지 대체텍스트",
"dispYn": "Y",
"expYn": "N",
"evtSchTag": "검색태그",
"evtTrgmnGbCd": "01",
"mbrGbCdList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
],
"mbrGradeCdList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
],
"dispMbrGradeList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
]
}
],
"uprFixEvtInfo": {
"evtNo": 12345,
"evtNm": "이벤트명 Sample",
"uprFixYn": "Y",
"evtObjCd": "01",
"evtLgrpCd": 10,
"evtMgrpCd": 13,
"evtExpNmCd": "01",
"sbscCntLmtCd": "01",
"evtPrgsStatCd": "01",
"evtStrDtm": "2026-01-01T00:00:00.000Z",
"evtEndDtm": "2026-01-01T00:00:00.000Z",
"buyStrDtm": "2026-01-01T00:00:00.000Z",
"buyEndDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
"evtUrlAddr": "/url",
"evtBnrPathNm": "/url",
"evtBnrFileNm": "이벤트배너명.jpeg",
"evtBnrAltCont": "이벤트배너이미지 대체텍스트",
"pcEvtBnrPathNm": "/url",
"pcEvtBnrFileNm": "PC이벤트배너명.png",
"pcEvtBnrAltCont": "PC이벤트배너이미지 대체텍스트",
"dispYn": "Y",
"expYn": "N",
"evtSchTag": "검색태그",
"evtTrgmnGbCd": "01",
"mbrGbCdList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
],
"mbrGradeCdList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
],
"dispMbrGradeList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
]
}
}Function Description
This is the basic API for retrieving event details.
Detailed Description
Retrieves data related to each event according to the event type.
Retrieves the latest 4 events (excluding surveys).
Survey events are excluded.
Revision History
Release v2.00_240401 : Added retrieval of purchaser drawing and purchase gift events
Release v2.00_240425: Added site number to the event detail retrieval and latest event list search conditions
string
1string
791Access Token
Event details retrieved successfully
Event List Detail Response
Event No.
12345Event Name
이벤트명 SampleEvent Type Major Category Code (EV001)
10Event Type Subcategory Code (EV002)
13Event Display Name Code (EV003)
01Event Purpose (EV004)
01Event Entry Eligibility Code (EV006)
01Number of Entries (EV007)
01Management Status (EV005)
01Event Start Date
Event End Date
Purchase Period Start Date
Purchase Period End Date
Application Period Start Date
Application Period End Date
Drawing/Confirmation Date
2023-08-18Winner Announcement Date/Time
2023-08-20Winner Announcement Display
2023-08-20Gift Shipment Date
2023-08-25Point Payout Date/Time
2023-08-25Event URL
/urlEvent Banner Path
/urlEvent Banner File Name
이벤트배너명.jpegEvent Banner Image Alt Text
이벤트배너이미지 대체텍스트PC Event Banner Path Name
/urlPC Event Banner File Name
PC 이벤트배너명.pngPC Event Banner Image Alt Text
PC 이벤트배너이미지 대체텍스트Display Status
YExample: YExposure Status
NEvent Search Tag
검색태그Personal Information Usage Consent Status
YPersonal Information Usage Terms
YPersonal Information Third-Party Provision Consent Status
YPersonal Information Third-Party Provision Terms
YWithholding Tax Deposit Start Date/Time
2023-08-22Withholding Tax Deposit End Date/Time
2023-08-31Event Template Usage Status
YEvent Target Classification Code (EV012)
01Attendance Count
7Event Display Message
이벤트 노출 메시지 SamplePrecautions
유의사항 SampleCustomer Center Guide Message Content
고객센터안내문구내용 SampleTotal Comment Count
19Total Order Amount
500000Minimum Entry Eligible Amount
10000Event Entry Application Status
YResult Code
0000Result Message
successAccordion Usage Status
YFailed to retrieve event details
GET /api/event/v1/marketing/getEventDetail?evtNo=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*
{
"evtNo": 12345,
"evtNm": "이벤트명 Sample",
"evtLgrpCd": 10,
"evtMgrpCd": 13,
"evtExpNmCd": "01",
"evtObjCd": "01",
"evtSbscPsbCd": "01",
"sbscCntLmtCd": "01",
"evtPrgsStatCd": "01",
"evtStrDtm": "2026-01-01T00:00:00.000Z",
"evtEndDtm": "2026-01-01T00:00:00.000Z",
"buyStrDtm": "2026-01-01T00:00:00.000Z",
"buyEndDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
"lotDt": "2023-08-18",
"winAncmDt": "2023-08-20",
"winAncmDispYn": "2023-08-20",
"pmgdSndDt": "2023-08-25",
"payDt": "2023-08-25",
"evtUrlAddr": "/url",
"evtBnrPathNm": "/url",
"evtBnrFileNm": "이벤트배너명.jpeg",
"evtBnrAltCont": "이벤트배너이미지 대체텍스트",
"pcEvtBnrPathNm": "/url",
"pcEvtBnrFileNm": "PC 이벤트배너명.png",
"pcEvtBnrAltCont": "PC 이벤트배너이미지 대체텍스트",
"dispYn": "Y",
"expYn": "N",
"evtSchTag": "검색태그",
"indInfoMkusAgrYn": "Y",
"indInfoMkusAgmt": "Y",
"indInfoThprPofAgrYn": "Y",
"indInfoThprPofAgmt": "Y",
"tubaDptStrDt": "2023-08-22",
"tubaDptEndDt": "2023-08-31",
"evtTmplUseYn": "Y",
"evtTrgmnGbCd": "01",
"mbrGbCdList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
],
"mbrGradeCdList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
],
"newEventList": [
{
"evtNo": 12345,
"evtNm": "이벤트명 Sample",
"uprFixYn": "Y",
"evtObjCd": "01",
"evtLgrpCd": 10,
"evtMgrpCd": 13,
"evtExpNmCd": "01",
"sbscCntLmtCd": "01",
"evtPrgsStatCd": "01",
"evtStrDtm": "2026-01-01T00:00:00.000Z",
"evtEndDtm": "2026-01-01T00:00:00.000Z",
"buyStrDtm": "2026-01-01T00:00:00.000Z",
"buyEndDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
"evtUrlAddr": "/url",
"evtBnrPathNm": "/url",
"evtBnrFileNm": "이벤트배너명.jpeg",
"evtBnrAltCont": "이벤트배너이미지 대체텍스트",
"pcEvtBnrPathNm": "/url",
"pcEvtBnrFileNm": "PC이벤트배너명.png",
"pcEvtBnrAltCont": "PC이벤트배너이미지 대체텍스트",
"dispYn": "Y",
"expYn": "N",
"evtSchTag": "검색태그",
"evtTrgmnGbCd": "01",
"mbrGbCdList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
],
"mbrGradeCdList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
],
"dispMbrGradeList": [
{
"evtNo": 12345,
"expGradeGbCd": 10,
"expTgtNo": 10
}
]
}
],
"attenList": [
{
"evtNo": 12345,
"aplyRnk": 1,
"payPoint": 500
}
],
"attenCount": 7,
"quizList": [
{
"evtNo": 12345,
"questNo": 412,
"questGbCd": 20,
"questCont": "질문내용 Sample!",
"questQestCnt": 3,
"cawrCont": "정답입니다!",
"dupAnsYn": "N",
"mdtyQuestYn": "Y",
"ansNo": 16,
"cawrYn": "N",
"questAnsCont": "질문답변내용 Sample!",
"questExpltList": [
{
"evtNo": 12345,
"questNo": 412,
"questExplNo": 16,
"questExplCont": "질문보기내용 Sample!",
"questBnrPathNm": "/url",
"questBnrFileNm": "질문배너명.jpeg"
}
],
"quizExpltList": [
{
"evtNo": 12345,
"questNo": 412,
"questExplNo": 16,
"questExplCont": "질문보기내용 Sample!",
"questBnrPathNm": "/url",
"questBnrFileNm": "질문배너명.jpeg"
}
]
}
],
"pmgdList": [
{
"evtNo": 12345,
"evtFvrSeq": 1,
"winRnk": 1,
"evtFvrTypCd": 10,
"evtFvrTypNm": 10,
"buyAmt": 50000,
"payMilg": 500,
"evtGoodsNm": "상품권 50000원권",
"promoNo": "C10001234",
"goodsNo": 10002111,
"goodsImg": "/url",
"payPnumCnt": 10,
"pmgdAmt": 30000,
"winmnChrgYn": "Y",
"tuba": 13000,
"winWtpsCnt": 10,
"evetTermDesc": "행사기간설명 Sample",
"evetCondDesc": "행사조건설명 Sample",
"etcDesc1": "기타설명1 Sample",
"etcDesc2": "기타설명2 Sample",
"etcDesc3": "기타설명3 Sample",
"etcDesc4": "기타설명4 Sample",
"etcDesc5": "기타설명5 Sample",
"paysTermDesc": "지급기간설명 Sample",
"saleStatCd": 10,
"paysYn": "N"
}
],
"tmplRelInfoList": [
{
"evtNo": 12345,
"evtTmplRelNo": 16,
"tmplNo": 412,
"tmplDtlGbCd": 10,
"tmplDtlCmpsCd": "text",
"tmplDtlSeq": 16,
"htmlFileCont": "MO HTML 내용입니다. </br>",
"pcHtmlFileCont": "PC HTML 내용입니다. </br>"
}
],
"tmplDtlInfoList": [
{
"tmplNo": 12,
"tmplDtlGbCd": 10,
"tmplDtlSeq": 1,
"tmplDtlCmpsCd": "text",
"tmplPrioRnk": 1,
"htmlFileCont": "MO HTML 내용입니다 </br>",
"pcHtmlFileCont": "PC HTML 내용입니다 </br>"
}
],
"evtExpMsg": "이벤트 노출 메시지 Sample",
"atndMtr": "유의사항 Sample",
"custCntrGdWrdCont": "고객센터안내문구내용 Sample",
"replyTotalCount": 19,
"replyList": [
{
"bbcNo": 412,
"evtNo": 12345,
"evtTmplRelNo": 16,
"evtBbGbCd": "text",
"bbcTitleNm": "게시글 제목",
"bbcCont": "게시글 내용입니다!.",
"wrtmnNm": "홍길동",
"wrtmnEmailAddr": "abc@gmail.com",
"mbrNo": 10001234,
"goodsNo": 10002111,
"dispSeq": 1,
"qryCnt": 101,
"recomCnt": 50,
"dispYn": "Y",
"pblYn": "N",
"delYn": "N",
"regDt": "2023-08-18",
"mbrNm": "홍길동",
"loginId": "guest01"
}
],
"myReplyList": [
{
"bbcNo": 412,
"evtNo": 12345,
"evtTmplRelNo": 16,
"evtBbGbCd": 10,
"bbcTitleNm": "게시글제목입니다!",
"bbcCont": "게시글내용입니다!",
"wrtmnNm": "플래티어",
"wrtmnEmailAddr": "/url",
"mbrNo": 10001234,
"goodsNo": 10002111,
"dispSeq": 1,
"qryCnt": 20,
"recomCnt": 10,
"dispYn": "Y",
"pblYn": "N",
"delYn": "Y",
"regDt": "2023-08-21",
"mbrNm": "홍길동",
"loginId": "guest01"
}
],
"attendanceList": [
{
"bbcNo": 412,
"evtNo": 12345,
"evtTmplRelNo": 16,
"evtBbGbCd": "text",
"bbcTitleNm": "게시글 제목",
"bbcCont": "게시글 내용입니다!.",
"wrtmnNm": "홍길동",
"wrtmnEmailAddr": "abc@gmail.com",
"mbrNo": 10001234,
"goodsNo": 10002111,
"dispSeq": 1,
"qryCnt": 101,
"recomCnt": 50,
"dispYn": "Y",
"pblYn": "N",
"delYn": "N",
"regDt": "2023-08-18",
"mbrNm": "홍길동",
"loginId": "guest01"
}
],
"orderList": [
{
"ordNo": "20230809O007943",
"ordDtm": "2026-01-01T00:00:00.000Z",
"ordAmt": 510000
}
],
"totOrdAmt": 500000,
"sbscPsbMinOrdAmt": 10000,
"evtSbscAplyYn": "Y",
"resultCd": "0000",
"resultMsg": "success",
"acdnUseYn": "Y"
}Function Description
This is the basic API for retrieving the event customer review (survey) list.
Detailed Description
Retrieves only customer review (survey) events.
There is no pinned-at-top setting.
Sort order
Based on the event start date
Revision History
Release v2.00_240425: Added site number to the event list search conditions
string
1string
1string
10string
NAccess Token
Customer review (survey) list retrieved successfully
Event Survey List Response
Total Page Count
1Current Page No.
10Failed to retrieve customer review (survey) list
GET /api/event/v1/marketing/getCustReviewList?pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*
{
"allPageCnt": 1,
"curPageNo": 10,
"evtBaseInfo": [
{
"evtNo": 12345,
"evtNm": "이벤트명 Sample",
"evtPrgsStatCd": "01",
"evtStrDtm": "2026-01-01T00:00:00.000Z",
"evtEndDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
"evtSbscAplyYn": "Y"
}
]
}Function Description
This is the basic API for retrieving event customer review (survey) details.
Detailed Description
Retrieves survey details using the event number as a parameter.
For logged-in users, checks whether they have submitted an entry.
For logged-in users, displays the questions and answers.
Revision History
Release v2.00_240425: Added site number to the event detail retrieval and latest event list search conditions
string
1string
1234Access Token
Customer review (survey) details retrieved successfully
Event Survey Response
Event No.
12345Event Name
이벤트명 SampleManagement Status (EV005)
01Event Start Date/Time
Event End Date/Time
Application Period Start Date
Application Period End Date
Event Entry Application Status
YFailed to retrieve customer review (survey) details
GET /api/event/v1/marketing/getCustReviewDetail?evtNo=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*
{
"evtNo": 12345,
"evtNm": "이벤트명 Sample",
"evtPrgsStatCd": "01",
"evtStrDtm": "2026-01-01T00:00:00.000Z",
"evtEndDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
"sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
"evtSbscAplyYn": "Y",
"questList": [
{
"evtNo": 12345,
"questNo": 412,
"questGbCd": 20,
"questCont": "질문내용 Sample!",
"questQestCnt": 3,
"cawrCont": "정답입니다!",
"dupAnsYn": "N",
"mdtyQuestYn": "Y",
"ansNo": 16,
"cawrYn": "N",
"questAnsCont": "질문답변내용 Sample!",
"questExpltList": [
{
"evtNo": 12345,
"questNo": 412,
"questExplNo": 16,
"questExplCont": "질문보기내용 Sample!",
"questBnrPathNm": "/url",
"questBnrFileNm": "질문배너명.jpeg"
}
],
"quizExpltList": [
{
"evtNo": 12345,
"questNo": 412,
"questExplNo": 16,
"questExplCont": "질문보기내용 Sample!",
"questBnrPathNm": "/url",
"questBnrFileNm": "질문배너명.jpeg"
}
]
}
],
"tmplRelInfoList": [
{
"evtNo": 12345,
"evtTmplRelNo": 16,
"tmplNo": 412,
"tmplDtlGbCd": 10,
"tmplDtlCmpsCd": "text",
"tmplDtlSeq": 16,
"htmlFileCont": "MO HTML 내용입니다. </br>",
"pcHtmlFileCont": "PC HTML 내용입니다. </br>"
}
],
"tmplDtlInfoList": [
{
"tmplNo": 12,
"tmplDtlGbCd": 10,
"tmplDtlSeq": 1,
"tmplDtlCmpsCd": "text",
"tmplPrioRnk": 1,
"htmlFileCont": "MO HTML 내용입니다 </br>",
"pcHtmlFileCont": "PC HTML 내용입니다 </br>"
}
],
"ansList": [
{
"evtNo": 12345,
"questNo": 412,
"questGbCd": 20,
"questCont": "질문내용 Sample!",
"questQestCnt": 3,
"cawrCont": "정답입니다!",
"dupAnsYn": "N",
"mdtyQuestYn": "Y",
"ansNo": 16,
"cawrYn": "N",
"questAnsCont": "질문답변내용 Sample!",
"questExpltList": [
{
"evtNo": 12345,
"questNo": 412,
"questExplNo": 16,
"questExplCont": "질문보기내용 Sample!",
"questBnrPathNm": "/url",
"questBnrFileNm": "질문배너명.jpeg"
}
],
"quizExpltList": [
{
"evtNo": 12345,
"questNo": 412,
"questExplNo": 16,
"questExplCont": "질문보기내용 Sample!",
"questBnrPathNm": "/url",
"questBnrFileNm": "질문배너명.jpeg"
}
]
}
]
}Last updated