> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/store-front-api/event-api/undefined-4.md). # 이벤트 조회 ## 이벤트 댓글 조회 > \## 기능 설명\ > \* 이벤트 댓글을 조회하는 API입니다.\ > \---\ > \## 상세 설명\ > \* 전체 혹은 사용자가 작성한 댓글을 조회합니다.\ > \## 수정 번호\ > \* Release v2.00\_240401 : 이벤트 댓글 조회 최초 개발\ > \* Release v2.00\_240425: 이벤트 댓글 목록 조회 조건에 사이트번호 추가
```json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getEventReplies":{"get":{"tags":["이벤트 조회"],"summary":"이벤트 댓글 조회","description":"## 기능 설명\n* 이벤트 댓글을 조회하는 API입니다.\n---\n## 상세 설명\n* 전체 혹은 사용자가 작성한 댓글을 조회합니다.\n## 수정 번호\n* Release v2.00_240401 : 이벤트 댓글 조회 최초 개발\n* Release v2.00_240425: 이벤트 댓글 목록 조회 조건에 사이트번호 추가\n","operationId":"getEventReplies","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string","description":"string"}},{"name":"evtNo","in":"query","description":"이벤트 번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"isAllReply","in":"query","description":"전체 조회 여부","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"이벤트 댓글 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventReplyResponse"}}}},"900":{"description":"이벤트 댓글 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventReplyResponse":{"type":"object","description":"이벤트 댓글 정보 Response","properties":{"totalCount":{"type":"integer","format":"int32"},"replyList":{"type":"array","items":{"$ref":"#/components/schemas/CcEvtBbInfoResponse"}}}},"CcEvtBbInfoResponse":{"type":"object","description":"이벤트 게시판 정보 Response","properties":{"bbcNo":{"type":"string","description":"게시글번호"},"evtNo":{"type":"string","description":"이벤트번호"},"evtTmplRelNo":{"type":"string","description":"이벤트템플릿관계번호"},"evtBbGbCd":{"type":"string","description":"이벤트게시판구코드(EV023)"},"bbcTitleNm":{"type":"string","description":"게시글제목명"},"bbcCont":{"type":"string","description":"게시글내용"},"wrtmnNm":{"type":"string","description":"작성자명"},"wrtmnEmailAddr":{"type":"string","description":"작성자이메일주소"},"mbrNo":{"type":"string","description":"회원번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"qryCnt":{"type":"integer","format":"int32","description":"조회수"},"recomCnt":{"type":"integer","format":"int32","description":"추천수"},"dispYn":{"type":"string","default":"Y","description":"전시여부"},"pblYn":{"type":"string","description":"공개여부"},"delYn":{"type":"string","description":"삭제여부"},"regDt":{"type":"string","description":"등록일자"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"회원아이디"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}} ``` ## 이벤트 목록 조회 > \## 기능 설명\ > \* 이벤트 목록을 기본 조회하는 API입니다.\ > \---\ > \## 상세 설명\ > \* 1페이지 당 최대 10개의 이벤트를 노출합니다.\ > \* 최신순/마감순 select Box 값으로 해당 sort로 이벤트들을 노출합니다.\ > \* 최상단 고정 이벤트 1개는 최상단에서 노출됩니다.\ > \* 설문 이벤트는 목록에서 노출되지 않습니다.\ > \---\ > \## 코드 정리\ > \* \`\`\`최신순/마감순\`\`\` : 01 : 최신순, 02 : 마감순\ > \## 수정 번호\ > \* Release v2.00\_240425: 이벤트 목록 조회 조건에 사이트번호 추가
````json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getEventList":{"get":{"tags":["이벤트 조회"],"summary":"이벤트 목록 조회","description":"## 기능 설명\n* 이벤트 목록을 기본 조회하는 API입니다.\n---\n## 상세 설명\n* 1페이지 당 최대 10개의 이벤트를 노출합니다.\n* 최신순/마감순 select Box 값으로 해당 sort로 이벤트들을 노출합니다.\n* 최상단 고정 이벤트 1개는 최상단에서 노출됩니다.\n* 설문 이벤트는 목록에서 노출되지 않습니다.\n---\n## 코드 정리\n* ```최신순/마감순``` : 01 : 최신순, 02 : 마감순\n## 수정 번호\n* Release v2.00_240425: 이벤트 목록 조회 조건에 사이트번호 추가\n","operationId":"getEventList","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string","description":"string"}},{"name":"evtSortGb","in":"query","description":"최신순/마감순","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"이벤트 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventInfoResponse"}}}},"900":{"description":"이벤트 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventInfoResponse":{"type":"object","description":"이벤트 목록 정보 Response","properties":{"allPageCnt":{"type":"integer","format":"int32","description":"전체 페이지 개수"},"curPageNo":{"type":"integer","format":"int32","description":"현재 페이지 번호"},"evtBrandList":{"type":"array","description":"이벤트 브랜드 List","items":{"$ref":"#/components/schemas/CcEvtAplyInfoResponse"}},"evtBaseInfo":{"type":"array","description":"이벤트 목록 상세","items":{"$ref":"#/components/schemas/EventInfoDetailResponse"}},"uprFixEvtInfo":{"$ref":"#/components/schemas/EventInfoDetailResponse","description":"최상단 이벤트 상세"}}},"CcEvtAplyInfoResponse":{"type":"object","description":"이벤트 적용범위 정보 Response","properties":{"brandNo":{"type":"string","description":"브랜드 번호"},"brandNm":{"type":"string","description":"브랜드 명"}}},"EventInfoDetailResponse":{"type":"object","description":"이벤트 목록 상세 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"uprFixYn":{"type":"string","description":"상단고정여부"},"evtObjCd":{"type":"string","description":"이벤트목적(EV004)"},"evtLgrpCd":{"type":"string","description":"이벤트유형 대분류코드(EV001)"},"evtMgrpCd":{"type":"string","description":"이벤트유형 중분류코드(EV002)"},"evtExpNmCd":{"type":"string","description":"이벤트노출명코드(EV003)"},"sbscCntLmtCd":{"type":"string","description":"응모횟수(EV007)"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"이벤트시작일"},"evtEndDtm":{"type":"string","format":"date-time","description":"이벤트종료일"},"buyStrDtm":{"type":"string","format":"date-time","description":"구매기간시작일"},"buyEndDtm":{"type":"string","format":"date-time","description":"구매기간종료일"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"응모/신청기간시작일"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"응모/신청기간종료일"},"evtUrlAddr":{"type":"string","description":"이벤트URL주소"},"evtBnrPathNm":{"type":"string","description":"이벤트배너경로명"},"evtBnrFileNm":{"type":"string","description":"이벤트배너파일명"},"evtBnrAltCont":{"type":"string","description":"이벤트배너이미지 대체텍스트"},"pcEvtBnrPathNm":{"type":"string","description":"pc 이벤트배너경로명"},"pcEvtBnrFileNm":{"type":"string","description":"pc 이벤트배너파일명"},"pcEvtBnrAltCont":{"type":"string","description":"pc 이벤트배너이미지 대체텍스트"},"dispYn":{"type":"string","default":"Y","description":"전시여부"},"expYn":{"type":"string","description":"노출여부"},"evtSchTag":{"type":"string","description":"이벤트검색태그"},"evtTrgmnGbCd":{"type":"string","description":"이벤트대상자구분코드(EV012)"},"mbrGbCdList":{"type":"array","description":"응모회원분류","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"mbrGradeCdList":{"type":"array","description":"응모회원등급","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"dispMbrGradeList":{"type":"array","description":"전시회원등급","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}}}},"CcEvtAplyGradeInfo":{"type":"object","description":"이벤트 적용등급 정보","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"expGradeGbCd":{"type":"string","description":"노출등급구분코드(EV018) [10 : 응모회원관리코드, 20 : 응모회원등급코드 ]"},"expTgtNo":{"type":"string","description":"노출대상번호(ME002,ME008)\n* `ME002` : [ 10 : 통합회원 , 20 : 일반회원, 30 : 소셜회원, 99 : 비회원 ]

\n* `ME008` : [ 10 : GREEN, 20 : FAMILY, 30 : GOLD, 40 : VIP, 50 : VVIP ]

\n"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}} ```` ## 이벤트 상세 조회 > \## 기능 설명\ > \* 이벤트 상세 조회 기본 API입니다.\ > \---\ > \## 상세 설명\ > \* 이벤트 유형에 맞춰 각 이벤트 관련 데이터를 조회합니다.\ > \* 최신 이벤트 4건을 조회합니다.(설문 제외)\ > \* 설문 이벤트는 제외됩니다.\ > \## 수정 번호\ > \* Release v2.00\_240401 : 구매자 추첨, 구매사은 이벤트 조회 추가\ > \* Release v2.00\_240425: 이벤트 상세 조회 및 최신 이벤트 목록 조회 조건에 사이트번호 추가
```json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getEventDetail":{"get":{"tags":["이벤트 조회"],"summary":"이벤트 상세 조회","description":"## 기능 설명\n* 이벤트 상세 조회 기본 API입니다.\n---\n## 상세 설명\n* 이벤트 유형에 맞춰 각 이벤트 관련 데이터를 조회합니다.\n* 최신 이벤트 4건을 조회합니다.(설문 제외)\n* 설문 이벤트는 제외됩니다.\n## 수정 번호\n* Release v2.00_240401 : 구매자 추첨, 구매사은 이벤트 조회 추가\n* Release v2.00_240425: 이벤트 상세 조회 및 최신 이벤트 목록 조회 조건에 사이트번호 추가\n","operationId":"getEventDetail","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string","description":"string"}},{"name":"evtNo","in":"query","description":"이벤트 번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"이벤트 상세 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventListDetailResponse"}}}},"900":{"description":"이벤트 상세 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventListDetailResponse":{"type":"object","description":"이벤트 목록 상세 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"evtLgrpCd":{"type":"string","description":"이벤트유형 대분류코드(EV001)"},"evtMgrpCd":{"type":"string","description":"이벤트유형 중분류코드(EV002)"},"evtExpNmCd":{"type":"string","description":"이벤트노출명코드(EV003)"},"evtObjCd":{"type":"string","description":"이벤트목적(EV004)"},"evtSbscPsbCd":{"type":"string","description":"이벤트응모가능코드(EV006)"},"sbscCntLmtCd":{"type":"string","description":"응모횟수(EV007)"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"이벤트시작일"},"evtEndDtm":{"type":"string","format":"date-time","description":"이벤트종료일"},"buyStrDtm":{"type":"string","format":"date-time","description":"구매기간시작일"},"buyEndDtm":{"type":"string","format":"date-time","description":"구매기간종료일"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"응모/신청기간시작일"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"응모/신청기간종료일"},"lotDt":{"type":"string","description":"추첨/확정일자"},"winAncmDt":{"type":"string","description":"당첨발표일시"},"winAncmDispYn":{"type":"string","description":"당첨발표전시"},"pmgdSndDt":{"type":"string","description":"사은품 발송일"},"payDt":{"type":"string","description":"포인트지급일시"},"evtUrlAddr":{"type":"string","description":"이벤트URL주소"},"evtBnrPathNm":{"type":"string","description":"이벤트배너경로명"},"evtBnrFileNm":{"type":"string","description":"이벤트배너파일명"},"evtBnrAltCont":{"type":"string","description":"이벤트배너이미지 대체텍스트"},"pcEvtBnrPathNm":{"type":"string","description":"PC용이벤트배너경로명"},"pcEvtBnrFileNm":{"type":"string","description":"PC용이벤트배너파일명"},"pcEvtBnrAltCont":{"type":"string","description":"PC용이벤트배너이미지 대체텍스트"},"dispYn":{"type":"string","default":"Y","description":"전시여부"},"expYn":{"type":"string","description":"노출여부"},"evtSchTag":{"type":"string","description":"이벤트검색태그"},"indInfoMkusAgrYn":{"type":"string","description":"개인정보이용동의여부"},"indInfoMkusAgmt":{"type":"string","description":"개인정보이용약관"},"indInfoThprPofAgrYn":{"type":"string","description":"개인정보제3자제공동의여부"},"indInfoThprPofAgmt":{"type":"string","description":"개인정보제3자제공약관"},"tubaDptStrDt":{"type":"string","description":"제세공과금입금시작일시"},"tubaDptEndDt":{"type":"string","description":"제세공과금입금종료일시"},"evtTmplUseYn":{"type":"string","description":"이벤트탬플릿사용여부"},"evtTrgmnGbCd":{"type":"string","description":"이벤트대상자구분코드(EV012)"},"mbrGbCdList":{"type":"array","description":"응모회원분류","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"mbrGradeCdList":{"type":"array","description":"응모회원등급","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"newEventList":{"type":"array","description":"최신 이벤트 4건","items":{"$ref":"#/components/schemas/EventInfoDetailResponse"}},"attenList":{"type":"array","description":"출석체크List","items":{"$ref":"#/components/schemas/AttenResponse"}},"attenCount":{"type":"integer","format":"int32","description":"출석 횟수"},"quizList":{"type":"array","description":"퀴즈List","items":{"$ref":"#/components/schemas/CcEvtQuestInfoResponse"}},"pmgdList":{"type":"array","description":"경품List","items":{"$ref":"#/components/schemas/CcEvtFvrInfoResponse"}},"tmplRelInfoList":{"type":"array","description":"이벤트템플릿관계정보 List","items":{"$ref":"#/components/schemas/CcEvtTmplRelInfo"}},"tmplDtlInfoList":{"type":"array","description":"이벤트템플릿상세정보 List","items":{"$ref":"#/components/schemas/CcEvtTmplDtlInfoResponse"}},"evtExpMsg":{"type":"string","description":"이벤트 노출 메시지"},"atndMtr":{"type":"string","description":"유의사항"},"custCntrGdWrdCont":{"type":"string","description":"고객센터안내문구내용"},"replyTotalCount":{"type":"integer","format":"int32","description":"댓글 총 갯수"},"replyList":{"type":"array","description":"전체 이벤트댓글 List","items":{"$ref":"#/components/schemas/CcEvtBbInfoResponse"}},"myReplyList":{"type":"array","description":"내가 쓴 이벤트댓글 List","items":{"$ref":"#/components/schemas/CcEvtMyBbInfoResponse"}},"attendanceList":{"type":"array","description":"출석","items":{"$ref":"#/components/schemas/CcEvtBbInfoResponse"}},"orderList":{"type":"array","description":"주문내역","items":{"$ref":"#/components/schemas/EventMemberOrderGoodsDtlResponse"}},"totOrdAmt":{"type":"integer","format":"int64","description":"주문 총 금액"},"sbscPsbMinOrdAmt":{"type":"integer","format":"int32","description":"응모가능최소금액"},"evtSbscAplyYn":{"type":"string","description":"이벤트 응모신청 여부"},"resultCd":{"type":"string","description":"결과코드"},"resultMsg":{"type":"string","description":"결과 메세지"},"acdnUseYn":{"type":"string","description":"아코디언사용여부"}}},"CcEvtAplyGradeInfo":{"type":"object","description":"이벤트 적용등급 정보","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"expGradeGbCd":{"type":"string","description":"노출등급구분코드(EV018) [10 : 응모회원관리코드, 20 : 응모회원등급코드 ]"},"expTgtNo":{"type":"string","description":"노출대상번호(ME002,ME008)\n* `ME002` : [ 10 : 통합회원 , 20 : 일반회원, 30 : 소셜회원, 99 : 비회원 ]

\n* `ME008` : [ 10 : GREEN, 20 : FAMILY, 30 : GOLD, 40 : VIP, 50 : VVIP ]

\n"}}},"EventInfoDetailResponse":{"type":"object","description":"이벤트 목록 상세 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"uprFixYn":{"type":"string","description":"상단고정여부"},"evtObjCd":{"type":"string","description":"이벤트목적(EV004)"},"evtLgrpCd":{"type":"string","description":"이벤트유형 대분류코드(EV001)"},"evtMgrpCd":{"type":"string","description":"이벤트유형 중분류코드(EV002)"},"evtExpNmCd":{"type":"string","description":"이벤트노출명코드(EV003)"},"sbscCntLmtCd":{"type":"string","description":"응모횟수(EV007)"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"이벤트시작일"},"evtEndDtm":{"type":"string","format":"date-time","description":"이벤트종료일"},"buyStrDtm":{"type":"string","format":"date-time","description":"구매기간시작일"},"buyEndDtm":{"type":"string","format":"date-time","description":"구매기간종료일"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"응모/신청기간시작일"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"응모/신청기간종료일"},"evtUrlAddr":{"type":"string","description":"이벤트URL주소"},"evtBnrPathNm":{"type":"string","description":"이벤트배너경로명"},"evtBnrFileNm":{"type":"string","description":"이벤트배너파일명"},"evtBnrAltCont":{"type":"string","description":"이벤트배너이미지 대체텍스트"},"pcEvtBnrPathNm":{"type":"string","description":"pc 이벤트배너경로명"},"pcEvtBnrFileNm":{"type":"string","description":"pc 이벤트배너파일명"},"pcEvtBnrAltCont":{"type":"string","description":"pc 이벤트배너이미지 대체텍스트"},"dispYn":{"type":"string","default":"Y","description":"전시여부"},"expYn":{"type":"string","description":"노출여부"},"evtSchTag":{"type":"string","description":"이벤트검색태그"},"evtTrgmnGbCd":{"type":"string","description":"이벤트대상자구분코드(EV012)"},"mbrGbCdList":{"type":"array","description":"응모회원분류","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"mbrGradeCdList":{"type":"array","description":"응모회원등급","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"dispMbrGradeList":{"type":"array","description":"전시회원등급","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}}}},"AttenResponse":{"type":"object","description":"출석보상 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"aplyRnk":{"type":"integer","format":"int32","description":"적용순위"},"payPoint":{"type":"integer","format":"int32","description":"지급포인트"}}},"CcEvtQuestInfoResponse":{"type":"object","description":"이벤트 질문 정보 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"questNo":{"type":"string","description":"질문번호"},"questGbCd":{"type":"string","description":"질문구분코드(EV017)"},"questCont":{"type":"string","description":"질문내용"},"questQestCnt":{"type":"integer","format":"int32","description":"질문문항수"},"cawrCont":{"type":"string","description":"정답내용"},"dupAnsYn":{"type":"string","description":"복수답변여부"},"mdtyQuestYn":{"type":"string","description":"필수질문여부"},"ansNo":{"type":"string","description":"답변번호"},"cawrYn":{"type":"string","description":"정답여부"},"questAnsCont":{"type":"string","description":"질문답변내용"},"questExpltList":{"type":"array","description":"설문보기 정보","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}},"quizExpltList":{"type":"array","description":"퀴즈보기 정보","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}}}},"CcEvtQuestExplInfo":{"type":"object","description":"이벤트 질문보기 정보","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"questNo":{"type":"string","description":"질문번호"},"questExplNo":{"type":"string","description":"질문보기번호"},"questExplCont":{"type":"string","description":"질문보기내용"},"questBnrPathNm":{"type":"string","description":"질문배너경로명"},"questBnrFileNm":{"type":"string","description":"질문배너파일명"}}},"CcEvtFvrInfoResponse":{"type":"object","description":"이벤트 혜택정보 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtFvrSeq":{"type":"string","description":"이벤트혜택순번"},"winRnk":{"type":"integer","format":"int32","description":"당첨순위"},"evtFvrTypCd":{"type":"string","description":"이벤트혜택유형코드(EV011)"},"evtFvrTypNm":{"type":"string","description":"이벤트혜택유형코드명"},"buyAmt":{"type":"integer","format":"int32","description":"구매금액"},"payMilg":{"type":"integer","format":"int32","description":"지급마일리지"},"evtGoodsNm":{"type":"string","description":"이벤트상품명"},"promoNo":{"type":"string","description":"프로모션번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsImg":{"type":"string","description":"상품이미지"},"payPnumCnt":{"type":"integer","format":"int32","description":"지급인원수"},"pmgdAmt":{"type":"integer","format":"int32","description":"경품금액"},"winmnChrgYn":{"type":"string","description":"당첨자부담여부"},"tuba":{"type":"integer","format":"int32","description":"제세공과금"},"winWtpsCnt":{"type":"integer","format":"int32","description":"당첨대기자수"},"evetTermDesc":{"type":"string","description":"행사기간설명"},"evetCondDesc":{"type":"string","description":"행사조건설명"},"etcDesc1":{"type":"string","description":"기타설명1"},"etcDesc2":{"type":"string","description":"기타설명2"},"etcDesc3":{"type":"string","description":"기타설명3"},"etcDesc4":{"type":"string","description":"기타설명4"},"etcDesc5":{"type":"string","description":"기타설명5"},"paysTermDesc":{"type":"string","description":"지급기간설명"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"paysYn":{"type":"string","description":"경품지급여부"}}},"CcEvtTmplRelInfo":{"type":"object","description":"이벤트 템플릿관계 정보","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtTmplRelNo":{"type":"string","description":"이벤트템플릿관계번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"tmplDtlGbCd":{"type":"string","description":"템플릿상세구분코드(EV014)\n* `자유구성` : \"01\"

\n* `게시판` : \"02\"

\n* `FAQ` : \"03\"

\n"},"tmplDtlCmpsCd":{"type":"string","description":"템플릿상세구성코드(EV016)\n* `HTML에디터` : \"11\"

\n* `한줄댓글` : \"21\"

\n* `출석체크` : \"22\"

\n* `FAQ` : \"23\"

\n* `게시글` : \"24\"

\n"},"tmplDtlSeq":{"type":"string","description":"템플릿상세순번"},"htmlFileCont":{"type":"string","description":"MOBILE용HTML파일내용"},"pcHtmlFileCont":{"type":"string","description":"PC용HTML파일내용"}}},"CcEvtTmplDtlInfoResponse":{"type":"object","description":"이벤트 상세 템플릿 정보 Response","properties":{"tmplNo":{"type":"string","description":"템플릿번호"},"tmplDtlGbCd":{"type":"string","description":"템플릿상세구분코드(EV014)"},"tmplDtlSeq":{"type":"string","description":"템플릿상세순번"},"tmplDtlCmpsCd":{"type":"string","description":"템플릿상세구성코드(EV016)"},"tmplPrioRnk":{"type":"string","description":"템플릿우선순위"},"htmlFileCont":{"type":"string","description":"MOBILE용HTML파일내용"},"pcHtmlFileCont":{"type":"string","description":"PC용HTML파일내용"}}},"CcEvtBbInfoResponse":{"type":"object","description":"이벤트 게시판 정보 Response","properties":{"bbcNo":{"type":"string","description":"게시글번호"},"evtNo":{"type":"string","description":"이벤트번호"},"evtTmplRelNo":{"type":"string","description":"이벤트템플릿관계번호"},"evtBbGbCd":{"type":"string","description":"이벤트게시판구코드(EV023)"},"bbcTitleNm":{"type":"string","description":"게시글제목명"},"bbcCont":{"type":"string","description":"게시글내용"},"wrtmnNm":{"type":"string","description":"작성자명"},"wrtmnEmailAddr":{"type":"string","description":"작성자이메일주소"},"mbrNo":{"type":"string","description":"회원번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"qryCnt":{"type":"integer","format":"int32","description":"조회수"},"recomCnt":{"type":"integer","format":"int32","description":"추천수"},"dispYn":{"type":"string","default":"Y","description":"전시여부"},"pblYn":{"type":"string","description":"공개여부"},"delYn":{"type":"string","description":"삭제여부"},"regDt":{"type":"string","description":"등록일자"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"회원아이디"}}},"CcEvtMyBbInfoResponse":{"type":"object","description":"이벤트 내 댓글 정보 Response","properties":{"bbcNo":{"type":"string","description":"게시글번호"},"evtNo":{"type":"string","description":"이벤트번호"},"evtTmplRelNo":{"type":"string","description":"이벤트템플릿관계번호"},"evtBbGbCd":{"type":"string","description":"이벤트게시판구코드(EV023)"},"bbcTitleNm":{"type":"string","description":"게시글제목명"},"bbcCont":{"type":"string","description":"게시글내용"},"wrtmnNm":{"type":"string","description":"작성자명"},"wrtmnEmailAddr":{"type":"string","description":"작성자이메일주소"},"mbrNo":{"type":"string","description":"회원번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"qryCnt":{"type":"integer","format":"int32","description":"조회수"},"recomCnt":{"type":"integer","format":"int32","description":"추천수"},"dispYn":{"type":"string","description":"전시여부"},"pblYn":{"type":"string","description":"공개여부"},"delYn":{"type":"string","description":"삭제여부"},"regDt":{"type":"string","description":"등록일자"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"회원아이디"}}},"EventMemberOrderGoodsDtlResponse":{"type":"object","description":"주문정보 상세 Response","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordDtm":{"type":"string","format":"date-time","description":"주문일자"},"ordAmt":{"type":"integer","format":"int64","description":"주문금액"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}} ``` ## 이벤트 고객리뷰(설문) 목록 조회 > \## 기능 설명\ > \* 이벤트 고객리뷰(설문) 목록 조회 기본 API입니다.\ > \---\ > \## 상세 설명\ > \* 고객리뷰(설문) 이벤트만 조회합니다.\ > \* 최상단 고정 여부가 존재하지 않습니다.\ > \* 정렬순서\ > \* 이벤트 시작일자 기준\ > \## 수정 번호\ > \* Release v2.00\_240425: 이벤트 목록 조회 조건에 사이트번호 추가
```json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getCustReviewList":{"get":{"tags":["이벤트 조회"],"summary":"이벤트 고객리뷰(설문) 목록 조회","description":"## 기능 설명\n* 이벤트 고객리뷰(설문) 목록 조회 기본 API입니다.\n---\n## 상세 설명\n* 고객리뷰(설문) 이벤트만 조회합니다.\n* 최상단 고정 여부가 존재하지 않습니다.\n* 정렬순서\n* 이벤트 시작일자 기준\n## 수정 번호\n* Release v2.00_240425: 이벤트 목록 조회 조건에 사이트번호 추가\n","operationId":"getCustReviewList","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string","description":"string"}},{"name":"myQuestViewYn","in":"query","description":"참여 설문 보기","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"고객리뷰(설문) 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventSurveyResponse"}}}},"900":{"description":"고객리뷰(설문) 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventSurveyResponse":{"type":"object","description":"이벤트 설문 목록 Response","properties":{"allPageCnt":{"type":"integer","format":"int32","description":"전체페이지개수"},"curPageNo":{"type":"integer","format":"int32","description":"현재페이지번호"},"evtBaseInfo":{"type":"array","description":"이벤트 상세","items":{"$ref":"#/components/schemas/EventSurveyDetailResponse"}}}},"EventSurveyDetailResponse":{"type":"object","description":"이벤트 설문 목록 상세 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"이벤트시작일시"},"evtEndDtm":{"type":"string","format":"date-time","description":"이벤트종료일시"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"응모/신청기간시작일"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"응모/신청기간종료일"},"evtSbscAplyYn":{"type":"string","description":"참여여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}} ``` ## 이벤트 고객리뷰(설문) 상세 조회 > \## 기능 설명\ > \* 이벤트 고객리뷰(설문) 상세 조회 기본 API입니다.\ > \---\ > \## 상세 설명\ > \* 이벤트 번호를 파라미터로 받아 설문 상세 조회를합니다.\ > \* 로그인 유저인 경우, 응모 신청여부를 확인합니다.\ > \* 로그인 유저인 경우, 질의응답을 노출합니다.\ > \## 수정 번호\ > \* Release v2.00\_240425: 이벤트 상세 조회 및 최신 이벤트 목록 조회 조건에 사이트번호 추가
```json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getCustReviewDetail":{"get":{"tags":["이벤트 조회"],"summary":"이벤트 고객리뷰(설문) 상세 조회","description":"## 기능 설명\n* 이벤트 고객리뷰(설문) 상세 조회 기본 API입니다.\n---\n## 상세 설명\n* 이벤트 번호를 파라미터로 받아 설문 상세 조회를합니다.\n* 로그인 유저인 경우, 응모 신청여부를 확인합니다.\n* 로그인 유저인 경우, 질의응답을 노출합니다.\n## 수정 번호\n* Release v2.00_240425: 이벤트 상세 조회 및 최신 이벤트 목록 조회 조건에 사이트번호 추가\n","operationId":"getCustReviewDetail","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string","description":"string"}},{"name":"evtNo","in":"query","description":"이벤트 번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"고객리뷰(설문) 상세 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventSurveyInfoResponse"}}}},"900":{"description":"고객리뷰(설문) 상세 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventSurveyInfoResponse":{"type":"object","description":"이벤트 설문 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"이벤트시작일시"},"evtEndDtm":{"type":"string","format":"date-time","description":"이벤트종료일시"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"응모/신청기간시작일"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"응모/신청기간종료일"},"evtSbscAplyYn":{"type":"string","description":"이벤트 응모신청 여부"},"questList":{"type":"array","description":"설문List","items":{"$ref":"#/components/schemas/CcEvtQuestInfoResponse"}},"tmplRelInfoList":{"type":"array","description":"이벤트템플릿관계정보 List","items":{"$ref":"#/components/schemas/CcEvtTmplRelInfo"}},"tmplDtlInfoList":{"type":"array","description":"이벤트템플릿상세정보 List","items":{"$ref":"#/components/schemas/CcEvtTmplDtlInfoResponse"}},"ansList":{"type":"array","description":"답변LIst","items":{"$ref":"#/components/schemas/CcEvtQuestInfoResponse"}}}},"CcEvtQuestInfoResponse":{"type":"object","description":"이벤트 질문 정보 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"questNo":{"type":"string","description":"질문번호"},"questGbCd":{"type":"string","description":"질문구분코드(EV017)"},"questCont":{"type":"string","description":"질문내용"},"questQestCnt":{"type":"integer","format":"int32","description":"질문문항수"},"cawrCont":{"type":"string","description":"정답내용"},"dupAnsYn":{"type":"string","description":"복수답변여부"},"mdtyQuestYn":{"type":"string","description":"필수질문여부"},"ansNo":{"type":"string","description":"답변번호"},"cawrYn":{"type":"string","description":"정답여부"},"questAnsCont":{"type":"string","description":"질문답변내용"},"questExpltList":{"type":"array","description":"설문보기 정보","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}},"quizExpltList":{"type":"array","description":"퀴즈보기 정보","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}}}},"CcEvtQuestExplInfo":{"type":"object","description":"이벤트 질문보기 정보","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"questNo":{"type":"string","description":"질문번호"},"questExplNo":{"type":"string","description":"질문보기번호"},"questExplCont":{"type":"string","description":"질문보기내용"},"questBnrPathNm":{"type":"string","description":"질문배너경로명"},"questBnrFileNm":{"type":"string","description":"질문배너파일명"}}},"CcEvtTmplRelInfo":{"type":"object","description":"이벤트 템플릿관계 정보","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtTmplRelNo":{"type":"string","description":"이벤트템플릿관계번호"},"tmplNo":{"type":"string","description":"템플릿번호"},"tmplDtlGbCd":{"type":"string","description":"템플릿상세구분코드(EV014)\n* `자유구성` : \"01\"

\n* `게시판` : \"02\"

\n* `FAQ` : \"03\"

\n"},"tmplDtlCmpsCd":{"type":"string","description":"템플릿상세구성코드(EV016)\n* `HTML에디터` : \"11\"

\n* `한줄댓글` : \"21\"

\n* `출석체크` : \"22\"

\n* `FAQ` : \"23\"

\n* `게시글` : \"24\"

\n"},"tmplDtlSeq":{"type":"string","description":"템플릿상세순번"},"htmlFileCont":{"type":"string","description":"MOBILE용HTML파일내용"},"pcHtmlFileCont":{"type":"string","description":"PC용HTML파일내용"}}},"CcEvtTmplDtlInfoResponse":{"type":"object","description":"이벤트 상세 템플릿 정보 Response","properties":{"tmplNo":{"type":"string","description":"템플릿번호"},"tmplDtlGbCd":{"type":"string","description":"템플릿상세구분코드(EV014)"},"tmplDtlSeq":{"type":"string","description":"템플릿상세순번"},"tmplDtlCmpsCd":{"type":"string","description":"템플릿상세구성코드(EV016)"},"tmplPrioRnk":{"type":"string","description":"템플릿우선순위"},"htmlFileCont":{"type":"string","description":"MOBILE용HTML파일내용"},"pcHtmlFileCont":{"type":"string","description":"PC용HTML파일내용"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://tech.x2bee.com/api/store-front-api/event-api/undefined-4.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.