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

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

μš”μ²­

HTTP μš”μ²­

GET /api/v2/member/outing-wishlist/events/{eventId}

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

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

경둜 λ³€μˆ˜

ν•„λ“œλͺ… μ„€λͺ…
eventId μ‘°νšŒν•  이벀트의 IDμž…λ‹ˆλ‹€.

λ³Έλ¬Έ

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

응닡

μš”μ²­μ— 성곡할 경우 이 λ©”μ†Œλ“œλŠ” λ‹€μŒκ³Ό 같은 ꡬ쑰의 응닡을 λ°˜ν™˜ν•©λ‹ˆλ‹€.

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

{
    "event_id": Integer,
    "name": Integer,
    "category": String,
    "description": String,
    "videos_featured_link": {
        "https://youtube.com/watch/...",
        ...
    },
    "start_date": Date,
    "end_date": Date,
    "place": {
      "name": String,
      "address_sg": String,
      "address_road": String,
      "coordinate": {
        "lat": Float,
        "lng": Float
      },
    }
}

속성

ν•„λ“œλͺ… μ„€λͺ…
event_id ν•΄λ‹Ή ν–‰μ‚¬μ˜ IDμž…λ‹ˆλ‹€.
name ν•΄λ‹Ή ν–‰μ‚¬μ˜ μ΄λ¦„μž…λ‹ˆλ‹€.
category ν•΄λ‹Ή ν–‰μ‚¬μ˜ μ„ΈλΆ€ λΆ„λ₯˜μž…λ‹ˆλ‹€. 예) νŒμ—…μŠ€ν† μ–΄
description AIκ°€ μ œκ³΅ν•˜λŠ” ν•΄λ‹Ή ν–‰μ‚¬μ˜ μš”μ•½ μ •λ³΄μž…λ‹ˆλ‹€.
videos_featured_link ν•΄λ‹Ή 행사가 μΆ”μΆœλ˜μ—ˆλ˜ 유튜브 μ˜μƒλ“€μ˜ μ£Όμ†Œ λͺ©λ‘μž…λ‹ˆλ‹€.
start_date 'yyyy-MM-dd'의 ν˜•μ‹μœΌλ‘œ μ œκ³΅λ˜λŠ” ν•΄λ‹Ή 행사가 μ‹œμž‘ν•˜λŠ” λ‚ μ§œμž…λ‹ˆλ‹€. null은 ν•΄λ‹Ή 행사가 아직 운영 기간이 정해지지 μ•Šμ•˜μŒμ„ λ‚˜νƒ€λƒ…λ‹ˆλ‹€.
end_date 'yyyy-MM-dd'의 ν˜•μ‹μœΌλ‘œ μ œκ³΅λ˜λŠ” ν•΄λ‹Ή 행사가 μ’…λ£Œν•˜λŠ” λ‚ μ§œμž…λ‹ˆλ‹€. null은 ν•΄λ‹Ή 행사가 아직 운영 기간이 정해지지 μ•Šμ•˜μŒμ„ λ‚˜νƒ€λƒ…λ‹ˆλ‹€.
place ν•΄λ‹Ή 행사가 μ§„ν–‰λ˜λŠ” μž₯μ†Œλ₯Ό λ‚˜νƒ€λ‚΄λŠ” ν•„λ“œμž…λ‹ˆλ‹€.
place.name ν•΄λ‹Ή μž₯μ†Œμ˜ μ΄λ¦„μž…λ‹ˆλ‹€.
place.address_sg μ‹œ + ꡬ ν˜•νƒœλ‘œ μ œκ³΅λ˜λŠ” ν•΄λ‹Ή μž₯μ†Œμ˜ μ£Όμ†Œμž…λ‹ˆλ‹€.
place.address_road λ„λ‘œλͺ… μ£Όμ†Œ ν˜•νƒœλ‘œ μ œκ³΅λ˜λŠ” ν•΄λ‹Ή μž₯μ†Œμ˜ μ£Όμ†Œμž…λ‹ˆλ‹€.
place.coordinate ν•΄λ‹Ή μž₯μ†Œκ°€ μœ„μΉ˜ν•œ 곳의 μ’Œν‘œ μ •λ³΄μž…λ‹ˆλ‹€.
place.coordinate.lat ν•΄λ‹Ή μž₯μ†Œκ°€ μœ„μΉ˜ν•œ 곳의 μœ„λ„μž…λ‹ˆλ‹€.
place.coordinate.lng ν•΄λ‹Ή μž₯μ†Œκ°€ μœ„μΉ˜ν•œ 곳의 κ²½λ„μž…λ‹ˆλ‹€.

였λ₯˜

λ‹€μŒ ν‘œλŠ” 이 λ©”μ†Œλ“œμ— λŒ€ν•œ ν˜ΈμΆœμ— λŒ€ν•œ μ‘λ‹΅μœΌλ‘œ APIκ°€ λ°˜ν™˜ν•  수 μžˆλŠ” 였λ₯˜λ“€μ˜ μ •λ³΄μž…λ‹ˆλ‹€.

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