Skip to main content
GET
이벤트 검색·목록

인증

X-RP-API-Key
string
header
필수

헤더

Accept-Language
string

응답 지원 로케일: ko, en, ja, zh-CN, zh-TW, es, fr, de, pt, th, vi. 미지정 시 ko 기본값

예시:

"ko"

쿼리 매개변수

keyword
string

이벤트명/설명 검색어

Maximum string length: 100
categories
string[]

카테고리 코드. 값은 /v1/codes/event-categories 참조

subjects
string[]

주제 코드. /v1/codes/event-subjects 참조

openTypes
string[]

오픈 타입: OFFLINE(오프라인·현장)/ONLINE(온라인)/ON_OFFLINE(온·오프라인 병행)/TBD(미정)

startDateFrom
string

시작일 ≥ (YYYY-MM-DD)

startDateTo
string

시작일 ≤ (YYYY-MM-DD)

status
string

상태 필터(이벤트 기간 기준). UPCOMING(시작 전, startDate>현재)/ONGOING(진행 중)/CLOSED(종료, endDate<현재).

page
integer<int32>

조회할 페이지 번호 (1부터 시작, 기본값 1)

필수 범위: x >= 1
pageSize
integer<int32>

페이지 크기(1~50, 기본 20)

필수 범위: 1 <= x <= 50

응답

OK

페이지네이션 응답. page 는 1부터 시작하며, page > totalPages 인 경우 items 는 빈 배열이다.

totalItems
integer<int64>
필수

전체 항목 수

totalPages
integer<int32>
필수

전체 페이지 수

page
integer<int32>
필수

현재 페이지 번호 (1부터 시작)

pageSize
integer<int32>
필수

페이지 크기

items
object[]
필수

현재 페이지 항목