컬렉션 장소 목록 조회

Tested

GET

/collections/{collectionId}/places

[설명]

게스트 호출 가능 API

ex. /collections/1/places?page=1&sortType=CREATED_AT_DESC&addedByMemberId=abc

addedByMemberId는 컬렉션 멤버 조회에서 알 수 있는 collection_member_id 입니다.

place category_id는 상인님이 공유해 주신 링크 2번째 탭에 있습니다.
https://docs.google.com/spreadsheets/d/1Gr-bcWMsaYP2LAPojjdHmy6gm9JgZjtzpdVCpa8NFaM/edit?gid=45278998#gid=45278998

[제약 조건]

없음

[에러]

COLLECTION_NOT_FOUND(404)

FORBIDDEN_NOT_GUEST(403)

FORBIDDEN_NOT_MEMBER(403)

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Query Params

Responses

🟢200

application/json

Successful response

Bodyapplication/json

🟠401Unauthorized

🟠404NotFound

Request Example

Shell

JavaScript

Java

Swift

curl --location '/collections//places?page=0&size=10&sortType=undefined&addedByMemberId=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,
    "size": 0,
    "page": 0
}

Modified at 2026-03-02 16:49:17

검색 결과에서 컬렉션에 장소 추가

컬렉션 장소 상세 조회