이벤트 조회

이벤트 댓글 조회

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
chevron-right
200

이벤트 댓글 조회 성공

*/*

이벤트 댓글 정보 Response

totalCountinteger · int32Optional
get
/v1/marketing/getEventReplies

이벤트 목록 조회

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
chevron-right
200

이벤트 목록 조회 성공

*/*

이벤트 목록 정보 Response

allPageCntinteger · int32Optional

전체 페이지 개수

curPageNointeger · int32Optional

현재 페이지 번호

get
/v1/marketing/getEventList

이벤트 상세 조회

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
chevron-right
200

이벤트 상세 조회 성공

*/*

이벤트 목록 상세 Response

evtNostringOptional

이벤트번호

Example: 12345
evtNmstringOptional

이벤트명

Example: 이벤트명 Sample
evtLgrpCdstringOptional

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

Example: 10
evtMgrpCdstringOptional

이벤트유형 중분류코드(EV002)

Example: 13
evtExpNmCdstringOptional

이벤트노출명코드(EV003)

Example: 01
evtObjCdstringOptional

이벤트목적(EV004)

Example: 01
evtSbscPsbCdstringOptional

이벤트응모가능코드(EV006)

Example: 01
sbscCntLmtCdstringOptional

응모횟수(EV007)

Example: 01
evtPrgsStatCdstringOptional

관리상태(EV005)

Example: 01
evtStrDtmstring · date-timeOptional

이벤트시작일

evtEndDtmstring · date-timeOptional

이벤트종료일

buyStrDtmstring · date-timeOptional

구매기간시작일

buyEndDtmstring · date-timeOptional

구매기간종료일

sbscAplyStrDtmstring · date-timeOptional

응모/신청기간시작일

sbscAplyEndDtmstring · date-timeOptional

응모/신청기간종료일

lotDtstringOptional

추첨/확정일자

Example: 2023-08-18
winAncmDtstringOptional

당첨발표일시

Example: 2023-08-20
winAncmDispYnstringOptional

당첨발표전시

Example: 2023-08-20
pmgdSndDtstringOptional

사은품 발송일

Example: 2023-08-25
payDtstringOptional

포인트지급일시

Example: 2023-08-25
evtUrlAddrstringOptional

이벤트URL주소

Example: /url
evtBnrPathNmstringOptional

이벤트배너경로명

Example: /url
evtBnrFileNmstringOptional

이벤트배너파일명

Example: 이벤트배너명.jpeg
evtBnrAltContstringOptional

이벤트배너이미지 대체텍스트

Example: 이벤트배너이미지 대체텍스트
pcEvtBnrPathNmstringOptional

PC용이벤트배너경로명

Example: /url
pcEvtBnrFileNmstringOptional

PC용이벤트배너파일명

Example: PC 이벤트배너명.png
pcEvtBnrAltContstringOptional

PC용이벤트배너이미지 대체텍스트

Example: PC 이벤트배너이미지 대체텍스트
dispYnstringOptional

전시여부

Default: YExample: Y
expYnstringOptional

노출여부

Example: N
evtSchTagstringOptional

이벤트검색태그

Example: 검색태그
indInfoMkusAgrYnstringOptional

개인정보이용동의여부

Example: Y
indInfoMkusAgmtstringOptional

개인정보이용약관

Example: Y
indInfoThprPofAgrYnstringOptional

개인정보제3자제공동의여부

Example: Y
indInfoThprPofAgmtstringOptional

개인정보제3자제공약관

Example: Y
tubaDptStrDtstringOptional

제세공과금입금시작일시

Example: 2023-08-22
tubaDptEndDtstringOptional

제세공과금입금종료일시

Example: 2023-08-31
evtTmplUseYnstringOptional

이벤트탬플릿사용여부

Example: Y
evtTrgmnGbCdstringOptional

이벤트대상자구분코드(EV012)

Example: 01
attenCountinteger · int32Optional

출석 횟수

Example: 7
evtExpMsgstringOptional

이벤트 노출 메시지

Example: 이벤트 노출 메시지 Sample
atndMtrstringOptional

유의사항

Example: 유의사항 Sample
custCntrGdWrdContstringOptional

고객센터안내문구내용

Example: 고객센터안내문구내용 Sample
replyTotalCountinteger · int32Optional

댓글 총 갯수

Example: 19
totOrdAmtinteger · int64Optional

주문 총 금액

Example: 500000
sbscPsbMinOrdAmtinteger · int32Optional

응모가능최소금액

Example: 10000
evtSbscAplyYnstringOptional

이벤트 응모신청 여부

Example: Y
resultCdstringOptional

결과코드

Example: 0000
resultMsgstringOptional

결과 메세지

Example: success
acdnUseYnstringOptional

아코디언사용여부

Example: Y
get
/v1/marketing/getEventDetail

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

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
chevron-right
200

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

*/*

이벤트 설문 목록 Response

allPageCntinteger · int32Optional

전체페이지개수

Example: 1
curPageNointeger · int32Optional

현재페이지번호

Example: 10
get
/v1/marketing/getCustReviewList

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

get

기능 설명

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


상세 설명

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

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

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

수정 번호

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

Query parameters
siteNostringOptional

string

Example: 1
evtNostringRequired

string

Example: 1234
Header parameters
AuthorizationanyOptional

Access Token

Responses
chevron-right
200

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

*/*

이벤트 설문 Response

evtNostringOptional

이벤트번호

Example: 12345
evtNmstringOptional

이벤트명

Example: 이벤트명 Sample
evtPrgsStatCdstringOptional

관리상태(EV005)

Example: 01
evtStrDtmstring · date-timeOptional

이벤트시작일시

evtEndDtmstring · date-timeOptional

이벤트종료일시

sbscAplyStrDtmstring · date-timeOptional

응모/신청기간시작일

sbscAplyEndDtmstring · date-timeOptional

응모/신청기간종료일

evtSbscAplyYnstringOptional

이벤트 응모신청 여부

Example: Y
get
/v1/marketing/getCustReviewDetail

Last updated