API 명세 - 여행 위시리스트에 추가한 행사 목록 조회 API

요청

HTTP 요청

GET /api/v2/member/outing-wishlist/events

매개변수

• 필수

이 메소드는 요청 시 필수로 요구하는 파라미터가 없습니다.

• 선택

필드명	타입	설명
ongoing	Boolean	현재 운영 중인 행사만 조회할 지의 여부입니다.
cursor	String	조회할 페이지의 커서입니다. 누락될 경우 결과의 첫 번째 페이지를 조회합니다.

본문

이 메소드는 요청 본문을 따로 필요로 하지 않습니다.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답을 반환합니다.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "next_cursor": String,
  "events": {
    {
      "event_id": Integer,
      "name": String,
      "category": String,
      "description": String,
      "start_date": Date,
      "end_date": Date,
      "place" : {
        "name": String,
        "address_sg": String
      }
    },
    ...
  }
}

속성

필드명	타입	설명
next_cursor	String	다음 페이지의 커서입니다. null일 경우 더 이상 조회할 결과가 없음을 의미합니다.
events	List	필터링 조건에 부합하는 행사들의 목록입니다.
event_id	Integer	해당 행사의 ID입니다.
name	String	해당 행사의 이름입니다.
category	String	해당 행사의 세부 분류입니다. 예) 팝업 스토어
description	String	AI가 제공하는 해당 행사의 요약 정보입니다.
start_date	Date ("yyyy-MM-dd")	해당 행사가 시작하는 날짜입니다.
end_date	Date ("yyyy-MM-dd")	해당 행사가 종료하는 날짜입니다.
place		해당 행사가 개최되는 장소를 나타냅니다.
place.name	String	해당 행사가 개최되는 장소의 이름입니다.
place.address_sg	String	시 + 구 형태로 제공되는 해당 행사가 개최되는 장소의 주소입니다.

오류

다음 표는 이 메소드에 대한 호출에 대한 응답으로 API가 반환할 수 있는 오류들의 정보입니다.

유형	세부정보	설명
401	INVALID_TOKEN	요청의 Authorization 헤더의 Bearer 토큰이 유효하지 않습니다.
404	PAGE_NOT_FOUND	요청에서 제공한 커서는 유효하나 커서가 가리키는 조회 결과 페이지를 찾을 수 없습니다.
422	INVALID_FILTER	요청에서 제공한 필터 조건이 유효하지 않습니다.
422	INVALID_CURSOR	요청에서 제공한 커서가 유효하지 않습니다.