Skip to content

GET 이벤트, 큐레이션 장소보기! (배너속 장소보기) (SP3, 영훈)

최영훈 edited this page Sep 24, 2020 · 8 revisions

[GET - 이벤트, 큐레이션 장소보기! (배너속 장소보기) (SP3, 영훈)

영훈 - ISSUE #144

figma참조

메소드 경로 설명
GET /places/group/:groupIdx/banner/:bannerIdx 그룹 내 북마크 한 장소 조회 (최신순)

요청 예시

{baseURL}/places/group/17/banner/2

요청 헤더

Content-Type: application/json
token: token

요청 파라미터

key 설명 타입 비고
groupIdx 검색할 그룹의 index String params
bannerIdx 검색할 banner index String params

응답 바디

key 설명 타입 비고
bannerTitle 배너 제목 String
bannerBadgeName 배너 뱃지 이름 String
bannerBadgeColor 배너 뱃지 색 String
bannerDescription 배너 설명 String
bannerCreatedAt 배너 생성일 int
bannerImageUrl 배너 이미지 String
placeIdx 장소 인덱스 int
placeName 장소 이름 String
likeCnt 좋아요수 Int
placeImageUrl 이미지 주소 String
subway 지하철명 Array String

성공

{
    "status": 200,
    "success": true,
    "message": "배너 리스트 조회 성공.",
    "data": {
        "banner": {
            "bannerTitle": "테스트",
            "bannerBadgeName": "테스트배지",
            "bannerDescription": "ㄹㅇ테스트용이다",
            "bannerBadgeColor": "#5BC9A1",
            "bannerCreatedAt": 15912351,
            "bannerImageUrl": ""
        },
        "places": [
            {
                "placeIdx": 249,
                "placeName": "롸카두들내쉬빌핫치킨",
                "likeCnt": 1,
                "subwayName": [
                    "용산역"
                ],
                "placeImageUrl": "https://sopt26.s3.ap-northeast-2.amazonaws.com/1600771352799.jpg"
            },
            {
                "placeIdx": 250,
                "placeName": "최미삼순대",
                "likeCnt": 0,
                "subwayName": [
                    "건대입구역",
                    "구의역"
                ],
                "placeImageUrl": "https://sopt26.s3.ap-northeast-2.amazonaws.com/1600926748291.png"
            },
            {
                "placeIdx": 252,
                "placeName": "선릉 루프",
                "likeCnt": 1,
                "subwayName": [
                    "종각역",
                    "공덕역"
                ],
                "placeImageUrl": "https://sopt26.s3.ap-northeast-2.amazonaws.com/1600930068041.jpeg"
            }
        ]
    }
}

실패

  • 그룹의 종속되지 않은 배너인덱스 호출시
{
    "status": 400,
    "success": true,
    "message": "배너 접근 권한 없음. 그룹 불일치!"
}
  • 서버 내부 에러
{
    "status": 500,
    "message": "배너 가져오기 실패'"
}
Clone this wiki locally