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

요청

HTTP 요청

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

매개변수

• 필수

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

• 선택

필드명	타입	설명
location	String	조회할 장소의 지역 기반 필터의 기준이 될 지역입니다. 유효한 지역은 도, 광역/특별시의 영문 명칭입니다. (예: "incheon")
cursor	String	조회할 페이지의 커서입니다. 누락될 경우 결과의 첫 번째 페이지를 조회합니다.

본문

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

응답

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

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

{
  "next_cursor": String,
  "places": {
    {
      "place_id": Integer,
      "name": String,
      "category": String,
      "description": String,
      "address_sg": String
    },
    ...
  }
}

속성

필드명	타입	설명
next_cursor	String	다음 페이지의 커서입니다. null일 경우 더 이상 조회할 결과가 없음을 의미합니다.
places	List	필터링 조건에 부합하는 장소들의 목록입니다.
place_id	Integer	해당 장소의 ID입니다.
name	String	해당 장소의 이름입니다.
category	String	해당 장소의 세부 분류입니다. 예) 카페
description	String	AI가 제공하는 해당 장소의 요약 정보입니다.
address_sg	String	시 + 구 형태로 제공되는 해당 장소의 주소입니다.

오류

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

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