이벤트 검색·목록
Events
이벤트 검색·목록
이벤트를 검색·필터링하여 페이지 단위로 조회한다. 키워드, 카테고리, 주제, 지역, 기간, 상태로 필터링하며, 시작일이 임박한 순(시작일 오름차순)으로 정렬한다.
GET
이벤트 검색·목록
인증
헤더
응답 지원 로케일: ko, en, ja, zh-CN, zh-TW, es, fr, de, pt, th, vi. 미지정 시 ko 기본값
예시:
"ko"
쿼리 매개변수
이벤트명/설명 검색어
Maximum string length:
100카테고리 코드. 값은 /v1/codes/event-categories 참조
주제 코드. /v1/codes/event-subjects 참조
오픈 타입: OFFLINE(오프라인·현장)/ONLINE(온라인)/ON_OFFLINE(온·오프라인 병행)/TBD(미정)
시작일 ≥ (YYYY-MM-DD)
시작일 ≤ (YYYY-MM-DD)
상태 필터(이벤트 기간 기준). UPCOMING(시작 전, startDate>현재)/ONGOING(진행 중)/CLOSED(종료, endDate<현재).
조회할 페이지 번호 (1부터 시작, 기본값 1)
필수 범위:
x >= 1페이지 크기(1~50, 기본 20)
필수 범위:
1 <= x <= 50