v2_apidocs_outingwishlist_readplace - 100-hours-a-week/KTB4-8th-BE GitHub Wiki

API λͺ…μ„Έ - μ—¬ν–‰ μœ„μ‹œλ¦¬μŠ€νŠΈμ— μΆ”κ°€ν•œ μž₯μ†Œ 상세 쑰회 API

μš”μ²­

HTTP μš”μ²­

GET /api/v2/member/outing-wishlist/places/{placeId}

λ§€κ°œλ³€μˆ˜

이 λ©”μ†Œλ“œλŠ” μš”μ²­ λ§€κ°œλ³€μˆ˜λ₯Ό λ”°λ‘œ ν•„μš”λ‘œ ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.

경둜 λ³€μˆ˜

ν•„λ“œλͺ… μ„€λͺ…
placeId μ‘°νšŒν•  μž₯μ†Œμ˜ IDμž…λ‹ˆλ‹€.

λ³Έλ¬Έ

이 λ©”μ†Œλ“œλŠ” μš”μ²­ 본문을 λ”°λ‘œ ν•„μš”λ‘œ ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.

응닡

속성

ν•„λ“œλͺ… μ„€λͺ…
place_id ν•΄λ‹Ή μž₯μ†Œμ˜ IDμž…λ‹ˆλ‹€.
name ν•΄λ‹Ή μž₯μ†Œμ˜ μ΄λ¦„μž…λ‹ˆλ‹€.
category ν•΄λ‹Ή μž₯μ†Œμ˜ μ„ΈλΆ€ λΆ„λ₯˜μž…λ‹ˆλ‹€. 예) 카페
address_sg μ‹œ + ꡬ ν˜•νƒœλ‘œ μ œκ³΅λ˜λŠ” ν•΄λ‹Ή μž₯μ†Œμ˜ μ£Όμ†Œμž…λ‹ˆλ‹€.
address_road λ„λ‘œλͺ… μ£Όμ†Œ ν˜•νƒœλ‘œ μ œκ³΅λ˜λŠ” ν•΄λ‹Ή μž₯μ†Œμ˜ μ£Όμ†Œμž…λ‹ˆλ‹€.
coordinate ν•΄λ‹Ή μž₯μ†Œκ°€ μœ„μΉ˜ν•œ 곳의 μ’Œν‘œ μ •λ³΄μž…λ‹ˆλ‹€.
coordinate.lat ν•΄λ‹Ή μž₯μ†Œκ°€ μœ„μΉ˜ν•œ 곳의 μœ„λ„μž…λ‹ˆλ‹€.
coordinate.lng ν•΄λ‹Ή μž₯μ†Œκ°€ μœ„μΉ˜ν•œ 곳의 κ²½λ„μž…λ‹ˆλ‹€.
description AIκ°€ μ œκ³΅ν•˜λŠ” ν•΄λ‹Ή μž₯μ†Œμ˜ μš”μ•½ μ •λ³΄μž…λ‹ˆλ‹€.
videos_featured_link ν•΄λ‹Ή μž₯μ†Œκ°€ μΆ”μΆœλ˜μ—ˆλ˜ 유튜브 μ˜μƒλ“€μ˜ λͺ©λ‘μž…λ‹ˆλ‹€.
save_date yyyy-MM-dd의 ν˜•νƒœλ‘œ μ œκ³΅λ˜λŠ” ν•΄λ‹Ή μž₯μ†Œκ°€ μ—¬ν–‰ μœ„μ‹œλ¦¬μŠ€νŠΈμ— μΆ”κ°€λ˜μ—ˆλ˜ λ‚ μ§œμž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

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

{
    "place_id": 12415,
    "name": "메가컀피 μ„±μˆ˜μ ",
    "category": "카페",
    "address_sg": "μ„œμšΈμ‹œ 성동ꡬ",
    "address_road": "μ„œμšΈνŠΉλ³„μ‹œ 성동ꡬ μ•„μ°¨μ‚°λ‘œ 100",
    "coordinate": {
        "lat": 37.5441,
        "lng": 127.0560
    },
    "description": "μ„±μˆ˜μ—­ 근처 건물 1측에 μžˆλŠ” 메가컀피",
    "videos_featured_link": {
        "https://www.youtube.com/watch?v=8tmaJYDMp5w",
        ...
    },
    "save_date": "2026-10-10"
}

였λ₯˜

μœ ν˜• 세뢀정보 μ„€λͺ…
401 INVALID_TOKEN μš”μ²­μ˜ Authorization ν—€λ”μ˜ Bearer 토큰이 μœ νš¨ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
404 PLACE_NOT_FOUND μš”μ²­μ—μ„œ 제곡된 μž₯μ†Œ IDκ°€ μœ νš¨ν•˜λ‚˜ μž₯μ†Œ IDκ°€ κ°€λ¦¬ν‚€λŠ” μž₯μ†Œλ₯Ό 찾을 수 μ—†μŠ΅λ‹ˆλ‹€.
422 INVALID_PLACE_ID μš”μ²­μ—μ„œ 제곡된 μž₯μ†Œ IDκ°€ μœ νš¨ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.