HomeAboutMeBlogGuest
© 2025 Sejin Cha. All rights reserved.
Built with Next.js, deployed on Vercel
♥️
2기 최종 프로젝트 팀별 공간/
[팀 09] 오프와 에프
[팀 09] 오프와 에프/
📝
API 명세서/
📢
요청/응답 값
📢

요청/응답 값

FE 연결
FE 연결
HTTP verbs
GET
Path
/api/v1/places?
기능
장소 목록 조회
담당자
Charlie
도메인
완료
완료

GET /api/v1/places?keyword=aaa …

요청 값(헤더)

"Authorization": String?

ex)
"Authorization":"234980234908sdkjhsjfhsda"

요청 값(params)

"keyword": String?,   // required = false
"sorting": String?,   // required = false (최신순, 인기순)
"region": String?     // required = false

"page": Number!,
"size": Number!,
"sort": String!, // ?sort=createdAt,desc
 
 

응답 값(200) - Slice의 객체 안에 들어갑니다

{
    "places":[
			{
				"id": Number!,
				"title": String!,
				"likeCount": Number!,
				"usedCount": Number!, // 몇개 코스에서 사용했는지
				"category": String!,
				"thumbnail": String!,
				"bookmarked": Boolean!
			}, ...
		],
    "pageable": {
        "sort": {
            "empty": true,
            "sorted": false,
            "unsorted": true
        },
        "offset": 0,
        "pageNumber": 0,
        "pageSize": 5,
        "paged": true,
        "unpaged": false
    },
    "sort": {
        "empty": true,
        "sorted": false,
        "unsorted": true
    },
    "size": 5,
    "number": 0,
    "first": true,
    "last": true,
    "numberOfElements": 0,
    "empty": true
}

응답 값(204) - No Content

//텅~

응답 값(500)

//잘못된 검색 조건을 입력했을 때