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

API λͺ…μ„Έ - μ—¬ν–‰ μœ„μ‹œλ¦¬μŠ€νŠΈ 쑰회 API

μš”μ²­

HTTP μš”μ²­

GET /api/v2/member/outing-wishlist

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

  • ν•„μˆ˜
ν•„λ“œλͺ… μ„€λͺ…
type μ‘°νšŒν•  μš”μ†Œμ˜ λΆ„λ₯˜μž…λ‹ˆλ‹€. place(κΈ°λ³Έκ°’), event, outingCourse 쀑 ν•˜λ‚˜μž…λ‹ˆλ‹€.
  • 선택
ν•„λ“œλͺ… μ„€λͺ…
location μ‘°νšŒν•  μž₯μ†Œμ˜ μ§€μ—­ 기반 ν•„ν„°μ˜ 기쀀이 될 μ§€μ—­μž…λ‹ˆλ‹€. μœ νš¨ν•œ 지역은 도, κ΄‘μ—­/νŠΉλ³„μ‹œμ˜ 영문 λͺ…μΉ­μž…λ‹ˆλ‹€. (예: "incheon")
cursor μ‘°νšŒν•  νŽ˜μ΄μ§€μ˜ μ»€μ„œμž…λ‹ˆλ‹€. λˆ„λ½λ  경우 결과의 첫 번째 νŽ˜μ΄μ§€λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€.

λ³Έλ¬Έ

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

응닡

속성

  • type=place인 경우
ν•„λ“œλͺ… μ„€λͺ…
next_cursor λ‹€μŒ νŽ˜μ΄μ§€μ˜ μ»€μ„œμž…λ‹ˆλ‹€. null일 경우 더 이상 μ‘°νšŒν•  κ²°κ³Όκ°€ μ—†μŒμ„ μ˜λ―Έν•©λ‹ˆλ‹€.
places 필터링 쑰건에 λΆ€ν•©ν•˜λŠ” μž₯μ†Œλ“€μ˜ λͺ©λ‘μž…λ‹ˆλ‹€.
place_id ν•΄λ‹Ή μž₯μ†Œμ˜ IDμž…λ‹ˆλ‹€.
name ν•΄λ‹Ή μž₯μ†Œμ˜ μ΄λ¦„μž…λ‹ˆλ‹€.
category ν•΄λ‹Ή μž₯μ†Œμ˜ μ„ΈλΆ€ λΆ„λ₯˜μž…λ‹ˆλ‹€. 예) 카페
description AIκ°€ μ œκ³΅ν•˜λŠ” ν•΄λ‹Ή μž₯μ†Œμ˜ μš”μ•½ μ •λ³΄μž…λ‹ˆλ‹€.
address_sg μ‹œ + ꡬ ν˜•νƒœλ‘œ μ œκ³΅λ˜λŠ” ν•΄λ‹Ή μž₯μ†Œμ˜ μ£Όμ†Œμž…λ‹ˆλ‹€.

μ˜ˆμ‹œ

  • type=place인 경우
HTTP/1.1 200 OK
Content-Type: application/json

{
  "next_cursor": String,
  "places": {
    {
      "place_id": 314,
      "name": "메가컀피 μ„±μˆ˜μ ",
      "category": "카페",
      "description": "μ„±μˆ˜μ—­ 근처 건물 1측에 μžˆλŠ” 메가컀피",
      "address_sg": "μ„œμšΈμ‹œ 성동ꡬ"
    },
    ...
  }
}

였λ₯˜

μœ ν˜• 세뢀정보 μ„€λͺ…
였λ₯˜ λ©”μ‹œμ§€(였λ₯˜ μ½”λ“œ) λŒ€μ‘λ˜λŠ” μ˜ˆμ™Έ 이름 μ„€λͺ