이벤트 조회

이벤트 댓글 조회

get

기능 설명

• 이벤트 댓글을 조회하는 API입니다.

---

상세 설명

• 전체 혹은 사용자가 작성한 댓글을 조회합니다.

수정 번호

• Release v2.00_240401 : 이벤트 댓글 조회 최초 개발

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

Query parameters

siteNostringOptional

string

Example: 1

evtNostringRequired

string

Example: 12345

isAllReplystringOptional

string

Example: Y

pageIdxstringOptional

string

Example: 1

rowsPerPagestringOptional

string

Example: 10

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

이벤트 댓글 조회 성공

*/*

900

이벤트 댓글 조회 실패

*/*

get

/v1/marketing/getEventReplies

HTTPcURLJavaScriptPython

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": "[email protected]",
      "mbrNo": 10001234,
      "goodsNo": 10002111,
      "dispSeq": 1,
      "qryCnt": 101,
      "recomCnt": 50,
      "dispYn": "Y",
      "pblYn": "N",
      "delYn": "N",
      "regDt": "2023-08-18",
      "mbrNm": "홍길동",
      "loginId": "guest01"
    }
  ]
}

이벤트 목록 조회

get

기능 설명

• 이벤트 목록을 기본 조회하는 API입니다.

---

상세 설명

• 1페이지 당 최대 10개의 이벤트를 노출합니다.

• 최신순/마감순 select Box 값으로 해당 sort로 이벤트들을 노출합니다.

• 최상단 고정 이벤트 1개는 최상단에서 노출됩니다.

• 설문 이벤트는 목록에서 노출되지 않습니다.

---

코드 정리

• 최신순/마감순 : 01 : 최신순, 02 : 마감순

수정 번호

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

Query parameters

siteNostringOptional

string

Example: 1

pageIdxstringRequired

string

Example: 1

rowsPerPagestringRequired

string

Example: 10

evtSortGbstringRequired

string

Example: 01

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

이벤트 목록 조회 성공

*/*

900

이벤트 목록 조회 실패

*/*

get

/v1/marketing/getEventList

HTTPcURLJavaScriptPython

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-03-21T17:48:40.140Z",
      "evtEndDtm": "2026-03-21T17:48:40.140Z",
      "buyStrDtm": "2026-03-21T17:48:40.140Z",
      "buyEndDtm": "2026-03-21T17:48:40.140Z",
      "sbscAplyStrDtm": "2026-03-21T17:48:40.140Z",
      "sbscAplyEndDtm": "2026-03-21T17:48:40.140Z",
      "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-03-21T17:48:40.140Z",
    "evtEndDtm": "2026-03-21T17:48:40.140Z",
    "buyStrDtm": "2026-03-21T17:48:40.140Z",
    "buyEndDtm": "2026-03-21T17:48:40.140Z",
    "sbscAplyStrDtm": "2026-03-21T17:48:40.140Z",
    "sbscAplyEndDtm": "2026-03-21T17:48:40.140Z",
    "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
      }
    ]
  }
}

이벤트 상세 조회

get

기능 설명

• 이벤트 상세 조회 기본 API입니다.

---

상세 설명

• 이벤트 유형에 맞춰 각 이벤트 관련 데이터를 조회합니다.

• 최신 이벤트 4건을 조회합니다.(설문 제외)

• 설문 이벤트는 제외됩니다.

수정 번호

• Release v2.00_240401 : 구매자 추첨, 구매사은 이벤트 조회 추가

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

Query parameters

siteNostringOptional

string

Example: 1

evtNostringRequired

string

Example: 791

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

이벤트 상세 조회 성공

*/*

900

이벤트 상세 조회 실패

*/*

get

/v1/marketing/getEventDetail

HTTPcURLJavaScriptPython

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-03-21T17:48:40.140Z",
  "evtEndDtm": "2026-03-21T17:48:40.140Z",
  "buyStrDtm": "2026-03-21T17:48:40.140Z",
  "buyEndDtm": "2026-03-21T17:48:40.140Z",
  "sbscAplyStrDtm": "2026-03-21T17:48:40.140Z",
  "sbscAplyEndDtm": "2026-03-21T17:48:40.140Z",
  "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-03-21T17:48:40.140Z",
      "evtEndDtm": "2026-03-21T17:48:40.140Z",
      "buyStrDtm": "2026-03-21T17:48:40.140Z",
      "buyEndDtm": "2026-03-21T17:48:40.140Z",
      "sbscAplyStrDtm": "2026-03-21T17:48:40.140Z",
      "sbscAplyEndDtm": "2026-03-21T17:48:40.140Z",
      "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": "[email protected]",
      "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": "[email protected]",
      "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-03-21T17:48:40.140Z",
      "ordAmt": 510000
    }
  ],
  "totOrdAmt": 500000,
  "sbscPsbMinOrdAmt": 10000,
  "evtSbscAplyYn": "Y",
  "resultCd": "0000",
  "resultMsg": "success",
  "acdnUseYn": "Y"
}

이벤트 고객리뷰(설문) 목록 조회

get

기능 설명

• 이벤트 고객리뷰(설문) 목록 조회 기본 API입니다.

---

상세 설명

• 고객리뷰(설문) 이벤트만 조회합니다.

• 최상단 고정 여부가 존재하지 않습니다.

• 정렬순서

• 이벤트 시작일자 기준

수정 번호

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

Query parameters

siteNostringOptional

string

Example: 1

pageIdxstringRequired

string

Example: 1

rowsPerPagestringRequired

string

Example: 10

myQuestViewYnstringOptional

string

Example: N

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

고객리뷰(설문) 목록 조회 성공

*/*

900

고객리뷰(설문) 목록 조회 실패

*/*

get

/v1/marketing/getCustReviewList

HTTPcURLJavaScriptPython

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-03-21T17:48:40.140Z",
      "evtEndDtm": "2026-03-21T17:48:40.140Z",
      "sbscAplyStrDtm": "2026-03-21T17:48:40.140Z",
      "sbscAplyEndDtm": "2026-03-21T17:48:40.140Z",
      "evtSbscAplyYn": "Y"
    }
  ]
}

이벤트 고객리뷰(설문) 상세 조회

get

기능 설명

• 이벤트 고객리뷰(설문) 상세 조회 기본 API입니다.

---

상세 설명

• 이벤트 번호를 파라미터로 받아 설문 상세 조회를합니다.

• 로그인 유저인 경우, 응모 신청여부를 확인합니다.

• 로그인 유저인 경우, 질의응답을 노출합니다.

수정 번호

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

Query parameters

siteNostringOptional

string

Example: 1

evtNostringRequired

string

Example: 1234

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

고객리뷰(설문) 상세 조회 성공

*/*

900

고객리뷰(설문) 상세 조회 실패

*/*

get

/v1/marketing/getCustReviewDetail

HTTPcURLJavaScriptPython

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-03-21T17:48:40.140Z",
  "evtEndDtm": "2026-03-21T17:48:40.140Z",
  "sbscAplyStrDtm": "2026-03-21T17:48:40.140Z",
  "sbscAplyEndDtm": "2026-03-21T17:48:40.140Z",
  "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"
        }
      ]
    }
  ]
}