> 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"}}}}}}
```