v2_apidocs_outingwishlist_readoutingcourse - 100-hours-a-week/KTB4-8th-BE GitHub Wiki
API λͺ μΈ - μ¬ν μμ리μ€νΈμ μΆκ°ν μ¬ν μ½μ€ μμΈ μ‘°ν API
μμ²
HTTP μμ²
GET /api/v2/member/outing-wishlist/outing-courses/{outingCourseId}
λ§€κ°λ³μ
μ΄ λ©μλλ μμ² νλΌλ―Έν°λ₯Ό λ°λ‘ νμλ‘ νμ§ μμ΅λλ€.
κ²½λ‘ λ³μ
| νλλͺ | μ€λͺ |
|---|---|
outingCourseId |
μ‘°νν μ¬ν μ½μ€μ IDμ λλ€. |
λ³Έλ¬Έ
μ΄ λ©μλλ μμ² λ³Έλ¬Έμ λ°λ‘ νμλ‘ νμ§ μμ΅λλ€.
μλ΅
μμ²μ μ±κ³΅ν κ²½μ° μ΄ λ©μλλ λ€μκ³Ό κ°μ ꡬ쑰μ μλ΅μ λ°νν©λλ€.
HTTP/1.1 200 OK
Content-Type: application/json
{
"course_id": Integer,
"name": String,
"duration_hours": Integer,
"stops": {
"count": Integer,
"items": {
"sequence": Integer,
"stop_id": Integer,
"name": String,
"type": String,
"category": String,
"coordinate": {
"lat": Float,
"lng": Float
},
"is_available": Boolean
}
}
}
μμ±
| νλλͺ | μ€λͺ |
|---|---|
course_id |
μ‘°νν μ¬ν μ½μ€μ IDμ λλ€. |
name |
ν΄λΉ μ¬ν μ½μ€μ μ΄λ¦μ λλ€. |
duration_hours |
ν΄λΉ μ¬ν μ½μ€μ μ΄ μμμκ°μ λλ€. |
stops |
ν΄λΉ μ½μ€λ₯Ό ꡬμ±νλ κ²½μ μ§λ€μ λνλ λλ€. |
stops.count |
ν΄λΉ μ½μ€λ₯Ό ꡬμ±νλ κ²½μ μ§μ μ΄ κ°μμ λλ€. |
stops.items |
κ²½μ μ§λ€μ λͺ©λ‘μ λλ€. |
stops.items.sequence |
ν΄λΉ μ½μ€μ ν΄λΉ κ²½μ μ§μ μλ²μ λλ€. |
stops.items.stop_id |
ν΄λΉ κ²½μ μ§μ IDμ λλ€. μ₯μμΈ κ²½μ° μ₯μ ID, νμ¬μΈ κ²½μ° νμ¬ IDλ₯Ό λνλ λλ€. |
stops.items.name |
ν΄λΉ κ²½μ μ§μ μ΄λ¦μ λλ€. |
stops.items.type |
ν΄λΉ κ²½μ μ§μ λΆλ₯μ
λλ€. place, event μ€ νλμ
λλ€. |
stops.items.category |
ν΄λΉ κ²½μ μ§μ μΈλΆ λΆλ₯μ λλ€. |
stops.items.coordinate |
ν΄λΉ κ²½μ μ§κ° μμΉν κ³³μ μ’ν μ 보μ λλ€. |
stops.items.coordinate.lat |
ν΄λΉ κ²½μ μ§κ° μμΉν κ³³μ μλμ λλ€. |
stops.items.coordinate.lng |
ν΄λΉ κ²½μ μ§κ° μμΉν κ³³μ κ²½λμ λλ€. |
stops.items.is_available |
ν΄λΉ κ²½μ μ§κ° νμ¬ μ΄μ© κ°λ₯νμ§μ μ¬λΆλ₯Ό λνλ λλ€. |
μ€λ₯
λ€μ νλ μ΄ λ©μλμ λν νΈμΆμ λν μλ΅μΌλ‘ APIκ° λ°νν μ μλ μ€λ₯λ€μ μ 보μ λλ€.
| μ ν | μΈλΆμ 보 | μ€λͺ |
|---|---|---|
401 |
INVALID_TOKEN |
μμ²μ Authorization ν€λμ Bearer ν ν°μ΄ μ ν¨νμ§ μμ΅λλ€. |
404 |
OUTING_COURSE_NOT_FOUND |
μμ²μμ μ 곡λ μ¬ν μ½μ€ IDκ° μ ν¨νλ μ¬ν μ½μ€ IDκ° κ°λ¦¬ν€λ μ¬ν μ½μ€λ₯Ό μ°Ύμ μ μμ΅λλ€. |
422 |
INVALID_OUTING_COURSE_ID |
μμ²μμ μ 곡λ μ¬ν μ½μ€ IDκ° μ ν¨νμ§ μμ΅λλ€. |