플랜에 연결된 컬렉션의 장소 조회

Tested

GET

/plans/{planId}/collections/{collectionId}/places

[설명]
플랜에 연결된 특정 컬렉션의 장소 목록을 페이징하여 조회합니다.

[제약 조건]

페이징 지원 (page, size)

정렬 지원 (sortType)

특정 멤버가 추가한 장소만 필터링 가능 (addedByMemberId)

[에러]
PLAN_NOT_FOUND(404): 플랜을 찾지 못 함
PLAN_COLLECTION_NOT_FOUND(404): 플랜에 등록된 컬렉션을 찾지 못 함
FORBIDDEN_NOT_MEMBER(403): 멤버 권한 필요

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403FORBIDDEN_NOT_MEMBER

🟠404PLAN_NOT_FOUND

🟠404PLAN_COLLECTION_NOT_FOUND

Request Example

Shell

JavaScript

Java

Swift

curl --location '/plans//collections//places?page=0&size=10&addedByMemberId=undefined&sortType=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "contents": [
        {
            "collection_place_id": "string",
            "memo": "string",
            "place": {
                "place_id": "53",
                "google_place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
                "name": "카페 오르빗",
                "address": "서울특별시 마포구 연남동 123-45",
                "category": {
                    "level1": {
                        "category_id": "",
                        "name": "F&B"
                    },
                    "level2": {
                        "category_id": "",
                        "name": "식당"
                    },
                    "level3": {
                        "category_id": "",
                        "name": "한식"
                    },
                    "primary_type": {
                        "category_id": "",
                        "name": "korean_restaurant"
                    }
                },
                "google_maps_uri": "https://maps.google.com/?cid=1234567890123456789",
                "photos": [
                    "https://lh3.googleusercontent.com/p/AF1QipNabc123",
                    "https://lh3.googleusercontent.com/p/AF1QipNdef456"
                ],
                "point": {
                    "latitude": "37.566535",
                    "longitude": "126.977969"
                }
            },
            "pick_pass": {
                "picked": {
                    "members": [
                        {
                            "collection_member_id": "string",
                            "nickname": "string",
                            "picture": "string",
                            "role": "OWNER"
                        }
                    ],
                    "count": 0
                },
                "passed": {
                    "members": [
                        {
                            "collection_member_id": "string",
                            "nickname": "string",
                            "picture": "string",
                            "role": "OWNER"
                        }
                    ],
                    "count": 0
                },
                "my_preference": "PICK "
            }
        }
    ],
    "has_next": true,
    "page": 0,
    "size": 0
}

Modified at 2026-03-03 12:52:56

플랜에 연결된 컬렉션 조회

플랜에 연결된 컬렉션의 장소 상세 조회