이벤트 응모

이벤트 댓글 수정

post

기능 설명

• 이벤트 댓글 수정 기본 API입니다.

---

상세 설명

• 로그인 필수입니다.

• 본인이 작성한 댓글만 수정 가능합니다.

• **댓글 내용(bbcCont), 이벤트 번호(evtNo), 회원번호(mbrNo), 게시글번호(bbcNo)**는 필수값입니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

이벤트 정보 Request

periodGbstringOptional

기간 검색 구분

• 시작일 : "0"
• 마감일 : "1"
• 추첨일 : "2"
• 발송일 : "3"

Example: 0

startDatestringOptional

시작일자

Example: 2023-08-17

endDatestringOptional

종료일자

Example: 2023-08-19

brandNostringOptional

브랜드 번호

Example: BR01

evtLgrpCdstringOptional

이벤트유형 대분류코드(EV001)

• 추첨이벤트 : "10"
• 비추첨이벤트 : "20"

Example: 10

evtTypstringOptional

이벤트유형

Example: 13

evtNmstringOptional

이벤트명

Example: 이벤트명

evtNostringOptional

이벤트번호

Example: 12345

deptCdstringOptional

진행부서 코드

Example: 01

aempIdstringOptional

담당자 ID

Example: admin12

dispYnstringOptional

전시여부

Default: YExample: Y

evtPrgsStatstringOptional

관리상태(EV005)

• 임시등록 : "01"
• 진행중 : "02"
• 추첨대기 : "03"
• 발표대기 : "04"
• 제세공과금입금진행중 : "05"
• 경품발송대기 : "06"
• 경품발송완료 : "07"
• 지급대기 : "08"
• 지급완료 : "09"
• 중단 : "10"
• 이벤트종료 : "11"

Example: 01

mbrNostringOptional

회원번호

Example: 10001234

evtSbscPathCdstringOptional

이벤트응모경로코드

Example: 30

evtSbscAplyChkYnstringOptional

이벤트 응모신청 가능여부 체크

Example: Y

winRnkinteger · int32Optional

당첨순위

Example: 1

evtTmplRelNostringOptional

댓글 템플릿 번호

Example: 11

bbcNostringOptional

댓글번호

Example: 100

bbcContstringOptional

댓글내용

Example: 댓글 내용입니다.

dispMbrGradestringOptional

전시회원등급

Example: 10

evtStartEndTabGbstringOptional

이벤트 진행중(01)&종료(02) 구분

Example: 01

evtSortGbstringOptional

이벤트 정렬 구분

Example: 01

uprFixYnstringOptional

상단고정여부

Example: Y

myQuestViewYnstringOptional

나의 참여 설문보기

Example: Y

evtObjCdstringOptional

이벤트목적코드

Example: 01

previewDatestringOptional

미리보기

Example: Y

recentEvtstringOptional

최신이벤트

Example: Y

trgmnSeqstringOptional

대상자순번

Example: 2712

fixCntinteger · int32Optional

상단고정 페이지처리값

Example: 1

mdCdstringOptional

매체코드

Example: 01

evtFvrSeqstringOptional

이벤트 혜택순번

Example: 3

sbscPsbMinOrdAmtinteger · int32Optional

응모가능최소금액

Example: 10000

evtMgrpCdstringOptional

이벤트중분류코드(EV002)

searchWordstringOptional

검색어

Example: 검색어

Responses

200

이벤트 댓글 수정 성공

*/*

900

이벤트 댓글 수정 실패

*/*

post

/v1/marketing/updateEventEntryReply

HTTPcURLJavaScriptPython

POST /api/event/v1/marketing/updateEventEntryReply HTTP/1.1
Host: api-event.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 873

{
  "periodGb": 0,
  "startDate": "2023-08-17",
  "endDate": "2023-08-19",
  "brandNo": "BR01",
  "evtLgrpCd": 10,
  "evtTyp": 13,
  "evtNm": "이벤트명",
  "evtNo": 12345,
  "deptCd": "01",
  "aempId": "admin12",
  "dispYn": "Y",
  "evtPrgsStat": "01",
  "mbrNo": 10001234,
  "evtSbscPathCd": 30,
  "evtSbscAplyChkYn": "Y",
  "winRnk": 1,
  "evtTmplRelNo": 11,
  "bbcNo": 100,
  "bbcCont": "댓글 내용입니다.",
  "dispMbrGrade": 10,
  "evtStartEndTabGb": "01",
  "evtSortGb": "01",
  "uprFixYn": "Y",
  "myQuestViewYn": "Y",
  "evtObjCd": "01",
  "questAnsList": [
    {
      "evtNo": 12345,
      "trgmnSeq": 2712,
      "questNo": 15,
      "ansNo": 16,
      "questAnsCont": "질문답변내용입니다.",
      "cawrYn": "N"
    }
  ],
  "quizAnsList": [
    {
      "evtNo": 12345,
      "trgmnSeq": 2712,
      "questNo": 15,
      "ansNo": 16,
      "questAnsCont": "질문답변내용입니다.",
      "cawrYn": "N"
    }
  ],
  "previewDate": "Y",
  "recentEvt": "Y",
  "trgmnSeq": 2712,
  "fixCnt": 1,
  "mdCd": "01",
  "evtFvrSeq": 3,
  "sbscPsbMinOrdAmt": 10000,
  "evtMgrpCd": "text",
  "searchWord": "검색어"
}

{
  "resultCd": "0000",
  "resultMsg": "success",
  "evtTrgmnGbCd": "01",
  "attenCount": 3,
  "payPoint": 500,
  "winRnk": 2
}

이벤트 응모 처리

post

기능 설명

• 이벤트 응모 기본 API입니다.

---

상세 설명

• 추첨 이벤트 : 구매자추첨 / 단순클릭 / 설문 / 댓글 / 룰렛

• 비추첨 이벤트 : 출석체크 / 구매사은 / 쿠폰 다운로드

• 구매사은 / 구매자추첨 이벤트인 경우

  • 응모 횟수 - 행사기간 1회

  • 응모 체크 - 구매 금액이 할당 금액을 채워야 응모 가능

• 출석체크 / 쿠폰다운로드 / 룰렛 이벤트인 경우

  • 응모된 순간, 즉시 경품 또는 마일리지 지급(당첨자)

---

수정번호

• Release v1.02_231023 : 룰렛 이벤트

• Release v1.03_231106 : 구매자추첨 이벤트

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

evtNostring · min: 1Required

이벤트번호

Example: 12345

evtSbscPathCdstringOptional

이벤트응모경로코드

Example: 30

evtTmplRelNostringOptional

댓글 템플릿 번호

Example: 11

bbcNostringOptional

댓글번호

Example: 100

bbcContstringOptional

댓글내용

Example: 댓글 내용입니다.

evtFvrSeqstringOptional

이벤트 혜택순번

Example: 3

commentExistsbooleanOptional

Responses

200

이벤트 응모 성공

*/*

900

이벤트 응모 실패

*/*

post

/v1/marketing/registerEvent

HTTPcURLJavaScriptPython

POST /api/event/v1/marketing/registerEvent HTTP/1.1
Host: api-event.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "evtNo": 12345,
  "evtSbscPathCd": 30,
  "evtTmplRelNo": 11,
  "bbcNo": 100,
  "bbcCont": "댓글 내용입니다.",
  "evtFvrSeq": 3,
  "questAnsList": [
    {
      "evtNo": 12345,
      "trgmnSeq": 2712,
      "questNo": 15,
      "ansNo": 16,
      "questAnsCont": "질문답변내용입니다.",
      "cawrYn": "N"
    }
  ],
  "commentExists": true
}

{
  "resultCd": "0000",
  "resultMsg": "success",
  "evtTrgmnGbCd": "01",
  "attenCount": 3,
  "payPoint": 500,
  "winRnk": 2
}

이벤트 댓글 삭제

post

기능 설명

• 이벤트 댓글 삭제 기본 API입니다.

---

상세 설명

• 로그인 필수입니다.

• 본인이 작성한 댓글만 삭제 가능합니다.

• 댓글 삭제 시, 본인 응모이력도 사라집니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

이벤트 정보 Request

periodGbstringOptional

기간 검색 구분

• 시작일 : "0"
• 마감일 : "1"
• 추첨일 : "2"
• 발송일 : "3"

Example: 0

startDatestringOptional

시작일자

Example: 2023-08-17

endDatestringOptional

종료일자

Example: 2023-08-19

brandNostringOptional

브랜드 번호

Example: BR01

evtLgrpCdstringOptional

이벤트유형 대분류코드(EV001)

• 추첨이벤트 : "10"
• 비추첨이벤트 : "20"

Example: 10

evtTypstringOptional

이벤트유형

Example: 13

evtNmstringOptional

이벤트명

Example: 이벤트명

evtNostringOptional

이벤트번호

Example: 12345

deptCdstringOptional

진행부서 코드

Example: 01

aempIdstringOptional

담당자 ID

Example: admin12

dispYnstringOptional

전시여부

Default: YExample: Y

evtPrgsStatstringOptional

관리상태(EV005)

• 임시등록 : "01"
• 진행중 : "02"
• 추첨대기 : "03"
• 발표대기 : "04"
• 제세공과금입금진행중 : "05"
• 경품발송대기 : "06"
• 경품발송완료 : "07"
• 지급대기 : "08"
• 지급완료 : "09"
• 중단 : "10"
• 이벤트종료 : "11"

Example: 01

mbrNostringOptional

회원번호

Example: 10001234

evtSbscPathCdstringOptional

이벤트응모경로코드

Example: 30

evtSbscAplyChkYnstringOptional

이벤트 응모신청 가능여부 체크

Example: Y

winRnkinteger · int32Optional

당첨순위

Example: 1

evtTmplRelNostringOptional

댓글 템플릿 번호

Example: 11

bbcNostringOptional

댓글번호

Example: 100

bbcContstringOptional

댓글내용

Example: 댓글 내용입니다.

dispMbrGradestringOptional

전시회원등급

Example: 10

evtStartEndTabGbstringOptional

이벤트 진행중(01)&종료(02) 구분

Example: 01

evtSortGbstringOptional

이벤트 정렬 구분

Example: 01

uprFixYnstringOptional

상단고정여부

Example: Y

myQuestViewYnstringOptional

나의 참여 설문보기

Example: Y

evtObjCdstringOptional

이벤트목적코드

Example: 01

previewDatestringOptional

미리보기

Example: Y

recentEvtstringOptional

최신이벤트

Example: Y

trgmnSeqstringOptional

대상자순번

Example: 2712

fixCntinteger · int32Optional

상단고정 페이지처리값

Example: 1

mdCdstringOptional

매체코드

Example: 01

evtFvrSeqstringOptional

이벤트 혜택순번

Example: 3

sbscPsbMinOrdAmtinteger · int32Optional

응모가능최소금액

Example: 10000

evtMgrpCdstringOptional

이벤트중분류코드(EV002)

searchWordstringOptional

검색어

Example: 검색어

Responses

200

이벤트 댓글 삭제 성공

*/*

900

이벤트 댓글 삭제 실패

*/*

post

/v1/marketing/deleteEventEntryReply

HTTPcURLJavaScriptPython

POST /api/event/v1/marketing/deleteEventEntryReply HTTP/1.1
Host: api-event.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 873

{
  "periodGb": 0,
  "startDate": "2023-08-17",
  "endDate": "2023-08-19",
  "brandNo": "BR01",
  "evtLgrpCd": 10,
  "evtTyp": 13,
  "evtNm": "이벤트명",
  "evtNo": 12345,
  "deptCd": "01",
  "aempId": "admin12",
  "dispYn": "Y",
  "evtPrgsStat": "01",
  "mbrNo": 10001234,
  "evtSbscPathCd": 30,
  "evtSbscAplyChkYn": "Y",
  "winRnk": 1,
  "evtTmplRelNo": 11,
  "bbcNo": 100,
  "bbcCont": "댓글 내용입니다.",
  "dispMbrGrade": 10,
  "evtStartEndTabGb": "01",
  "evtSortGb": "01",
  "uprFixYn": "Y",
  "myQuestViewYn": "Y",
  "evtObjCd": "01",
  "questAnsList": [
    {
      "evtNo": 12345,
      "trgmnSeq": 2712,
      "questNo": 15,
      "ansNo": 16,
      "questAnsCont": "질문답변내용입니다.",
      "cawrYn": "N"
    }
  ],
  "quizAnsList": [
    {
      "evtNo": 12345,
      "trgmnSeq": 2712,
      "questNo": 15,
      "ansNo": 16,
      "questAnsCont": "질문답변내용입니다.",
      "cawrYn": "N"
    }
  ],
  "previewDate": "Y",
  "recentEvt": "Y",
  "trgmnSeq": 2712,
  "fixCnt": 1,
  "mdCd": "01",
  "evtFvrSeq": 3,
  "sbscPsbMinOrdAmt": 10000,
  "evtMgrpCd": "text",
  "searchWord": "검색어"
}

{
  "resultCd": "0000",
  "resultMsg": "success",
  "evtTrgmnGbCd": "01",
  "attenCount": 3,
  "payPoint": 500,
  "winRnk": 2
}